npm 的命令行工具提供了丰富的子命令,涵盖了从项目初始化、依赖管理到包发布、调试等全流程。
下面按 常用分类 和 完整内置命令列表 两个维度整理,方便查阅。
npm list -g --depth=0 npm uninstall -g @anthropic-ai/claude-code
| 分类 | 常用命令 | 说明 |
|---|---|---|
| 项目初始化 | npm init | 创建 package.json,可用 npm init -y 快速生成 |
| 依赖安装 | npm install(简写 npm i) | 安装 package.json 中所有依赖;加 -g 全局安装;加 --save-dev 开发依赖 |
| 卸载依赖 | npm uninstall(简写 npm rm) | 卸载包,全局加 -g |
| 更新依赖 | npm update | 更新包到符合 package.json 版本范围的最新版 |
| 查看已安装 | npm list(简写 npm ls) | 查看本地或全局(加 -g)已安装的包树 |
| 运行脚本 | npm run | 执行 package.json 中定义的 scripts 脚本;npm start、npm test 可省略 run |
| 包发布 | npm publish | 将当前包发布到 npm 仓库 |
| 登录/登出 | npm login / npm logout | 管理 npm 账号登录状态 |
| 配置管理 | npm config | 设置或读取 npm 配置(如 registry、proxy) |
| 查看包信息 | npm view(简写 npm v) | 查看包在 registry 中的详细信息 |
| 缓存清理 | npm cache clean | 清理 npm 缓存,解决缓存导致的问题 |
| 审计安全 | npm audit | 检查依赖中的安全漏洞并尝试修复 |
以下所有命令均可通过
npm <command> --help查看详细用法。
| 命令 | 简要说明 |
|---|---|
npm access | 设置包访问权限(公开/私有) |
npm adduser(别名 login) | 添加用户到 registry(实际与 npm login 相同) |
npm audit | 审计依赖安全漏洞并自动修复 |
npm bin | 显示 npm 的 bin 目录路径 |
npm bugs | 打开包的 issues 页面 |
npm cache | 管理 npm 缓存 |
npm ci | 根据 package-lock.json 安装依赖(用于 CI 环境,更快更严格) |
npm completion | 生成 bash/zsh 命令补全脚本 |
npm config | 管理 npm 配置 |
npm dedupe | 简化依赖树,减少冗余 |
npm deprecate | 为包的某个版本设置废弃警告 |
npm diff | 比较本地文件与包版本的差异 |
npm dist-tag | 管理包的发行标签(如 latest、beta) |
npm docs(别名 home) | 在浏览器中打开包的文档页面 |
npm doctor | 检查 npm 环境健康状态 |
npm edit | 编辑已安装包的源文件 |
npm exec(别名 x) | 执行命令,自动补全 node_modules/.bin 路径 |
npm explain(别名 why) | 解释为什么某个包被安装 |
npm explore | 进入已安装包的目录并执行命令 |
npm find-dupes | 查找依赖树中重复的包 |
npm fund | 显示依赖包的捐赠信息 |
npm get | 获取某个配置项的值 |
npm help | 查看帮助文档 |
npm hook | 管理 registry hook(webhook 通知) |
npm init | 创建 package.json 文件 |
npm install(别名 i) | 安装包 |
npm install-ci-test | 先 ci 再运行测试 |
npm install-test | 先 install 再运行测试 |
npm link | 本地软链接包(用于开发调试) |
npm list(别名 ls) | 列出已安装的包 |
npm login(别名 adduser) | 登录 npm registry |
npm logout | 登出 |
npm ls(见 list) | 同上 |
npm npm | 无操作,用于测试 npm 是否正常运行 |
npm org | 管理组织(organization)成员 |
npm outdated | 检查哪些包有新版本 |
npm owner(别名 author) | 管理包的维护者 |
npm pack | 打包当前目录为 .tgz 文件 |
npm ping | 测试 registry 是否可达 |
npm pkg | 管理和编辑 package.json 字段 |
npm prefix | 显示当前包的根目录路径 |
npm profile | 管理用户个人资料信息 |
npm prune | 移除多余的包(不在依赖列表中的) |
npm publish | 发布包到 registry |
npm query | 使用 CSS 选择器查询依赖树 |
npm rebuild | 重新编译 native 模块 |
npm repo | 打开包的仓库页面 |
npm restart | 运行 restart 脚本 |
npm root | 显示 npm 的依赖安装根目录 |
npm run-script(别名 run) | 执行 package.json 中的脚本 |
npm search | 在 registry 中搜索包 |
npm set | 设置配置项 |
npm shrinkwrap | 锁定依赖版本(生成 npm-shrinkwrap.json) |
npm star / npm stars | 标记/查看喜欢的包 |
npm start | 运行 start 脚本 |
npm stop | 运行 stop 脚本 |
npm team | 管理组织团队权限 |
npm test(别名 t) | 运行 test 脚本 |
npm token | 管理访问令牌(用于 CI/CD) |
npm uninstall(别名 rm, r, un) | 卸载包 |
npm unpublish | 从 registry 撤回已发布的包 |
npm unstar | 取消标记喜爱的包 |
npm update(别名 up, upgrade) | 更新包 |
npm version | 修改包版本号并提交 git tag |
npm view(别名 v) | 查看包的 registry 信息 |
npm whoami | 显示当前登录的用户名 |
npm help 会列出所有命令的简要帮助。npm <command> -h 查看具体命令的用法。本文作者:Weee
本文链接:
版权声明:本博客所有文章除特别声明外,均采用 BY-NC-SA 许可协议。转载请注明出处!