npm 命令速查
共 47 条常用 npm / pnpm 命令，覆盖初始化安装、查看更新、脚本运行、卸载清理、发布版本、 配置镜像六组场景，逐条给出命令与说明。支持搜索与分类筛选，点击命令即可复制。
初始化与安装
创建项目、安装依赖。
| 命令 | 说明 |
|---|---|
| 快速生成 package.json（全部默认值） | |
| 按 package.json 安装全部依赖 | |
| 安装并写入 dependencies | |
| 安装到 devDependencies | |
| 全局安装 | |
| 安装指定版本 | |
| 安装最新版本 | |
| 按 lockfile 精确安装（CI 推荐） | |
| pnpm 安装依赖（更省空间、更快） |
查看与更新
查看版本、依赖树与可更新项。
| 命令 | 说明 |
|---|---|
| 以树形列出已安装依赖 | |
| 只列出顶层依赖 | |
| 列出可更新的依赖及当前/最新版本 | |
| 按 semver 范围更新依赖 | |
| 把某依赖升到最新版 | |
| 查看某包的可用版本列表 | |
| 查看某包的详细信息 | |
| pnpm 中查看某包被谁依赖 |
脚本与运行
运行 package.json 中的脚本。
| 命令 | 说明 |
|---|---|
| 运行 scripts.dev | |
| 运行 scripts.build | |
| 运行测试脚本（等价 npm run test） | |
| 运行启动脚本 | |
| 列出所有可用脚本 | |
| 追加参数透传给底层命令 | |
| 不安装运行一次性 CLI 工具 | |
| pnpm 版本的一次性执行 |
卸载与清理
移除依赖与清理缓存。
| 命令 | 说明 |
|---|---|
| 卸载依赖并从 package.json 移除 | |
| 卸载全局包 | |
| 移除 package.json 中未声明的依赖 | |
| 强制清空 npm 缓存 | |
| 校验并回收缓存空间 | |
| 彻底重装依赖（解决怪问题） | |
| 清理 pnpm 全局存储中的无用包 |
发布与版本
打版本号、发布与登录。
| 命令 | 说明 |
|---|---|
| 登录 npm 账号 | |
| 自动把补丁版本号 +1 并打提交标签 | |
| 次版本号 +1 | |
| 主版本号 +1 | |
| 发布当前包到 registry | |
| 发布 scoped 包并设为公开 | |
| 打包成 .tgz 预览将要发布的内容 | |
| 撤回已发布版本（72 小时内限制） |
配置与镜像
registry、代理与配置文件。
| 命令 | 说明 |
|---|---|
| 查看当前 registry 地址 | |
| 切换为国内镜像源 | |
| 设置代理 | |
| 列出全部配置项 | |
| 测试与 registry 的连通性 | |
| 体检本地 npm 环境是否正常 | |
| pnpm 切换镜像源 |
使用说明
把 npm 与 pnpm 的常用命令按场景整理成一张可搜索的对照表，覆盖初始化安装、查看更新、脚本运行、卸载清理、发布版本、配置镜像六组，逐条给出命令与说明。纯静态数据，页面在浏览器本地展示，点击命令即可复制。
- 用搜索框按用途找命令，如 install、更新、镜像、发布、清理。
- 点分类按钮切到某一组，例如「脚本与运行」或「配置与镜像」。
- 点命令即可复制，粘贴到终端执行。
- 遇到依赖装不上或版本冲突时，优先看「卸载与清理」与「查看与更新」。
常见问题
- npm install 和 npm ci 该用哪个？
- 本地开发用 npm install；CI/部署环境用 npm ci，它会严格按 package-lock.json 精确安装、先清空 node_modules，结果可复现且更快。
- 依赖装得很慢或失败怎么办？
- 多数是网络与 registry 问题。可切换到国内镜像源（npm config set registry https://registry.npmmirror.com），或检查代理设置；仍失败可清缓存后重试。
- -D 和 --save-dev 是一回事吗？
- 是的，-D 是 --save-dev 的简写，会把包写入 devDependencies（仅开发用）；不加 -D 则写入 dependencies（运行依赖）。