【npm】npm命令大全

以下是 npm 的常用命令大全，涵盖了从基础到高级的各种命令：

文章目录

基础命令

项目初始化

bash 复制代码

npm init                    # 交互式创建 package.json
npm init -y                 # 快速创建（使用默认值）
npm init <initializer>      # 使用创建工具（如：npm init react-app）

包安装

bash 复制代码

# 安装依赖
npm install                 # 安装所有依赖（根据 package.json）
npm i                       # install 的简写

# 安装生产依赖
npm install <package>       # 安装到 dependencies
npm i <package>

# 安装开发依赖
npm install <package> --save-dev    # 安装到 devDependencies
npm i <package> -D

# 安装全局包
npm install <package> --global      # 全局安装
npm i <package> -g

# 安装指定版本
npm install <package>@<version>     # 安装指定版本
npm install <package>@latest        # 安装最新版本

# 其他安装选项
npm install --production     # 只安装生产依赖（跳过 devDependencies）
npm install --no-optional    # 跳过可选依赖
npm install --force          # 强制重新安装

包卸载

bash 复制代码

npm uninstall <package>              # 卸载包
npm uninstall <package> --save-dev   # 卸载开发依赖
npm un <package>                     # 简写
npm rm <package>                     # 简写

包更新

bash 复制代码

npm update                    # 更新所有包到最新版本
npm update <package>          # 更新指定包
npm outdated                  # 检查过时的包

脚本相关命令

bash 复制代码

npm run <script>              # 运行 package.json 中的脚本
npm run                       # 显示所有可用的脚本
npm start                     # 运行 start 脚本（简写，不需要 run）
npm test                      # 运行 test 脚本（简写）
npm stop                      # 运行 stop 脚本（简写）
npm restart                   # 运行 restart 脚本（简写）

# 带参数运行
npm run <script> -- --flag    # 向脚本传递参数

信息查询命令

bash 复制代码

npm list                      # 查看当前项目安装的包（树状结构）
npm list -g                   # 查看全局安装的包
npm list --depth=0            # 查看顶层依赖（不显示依赖的依赖）
npm list <package>            # 查看特定包的信息

npm info <package>            # 查看包详细信息
npm view <package> versions   # 查看包的所有版本
npm search <keyword>          # 搜索包
npm docs <package>            # 打开包的文档
npm home <package>            # 打开包的主页

发布相关命令

bash 复制代码

npm login                     # 登录 npm 账号
npm logout                    # 退出登录
npm whoami                    # 查看当前登录用户

npm publish                   # 发布包
npm unpublish <package>       # 撤销发布（72小时内）
npm deprecate <package> "<message>"  # 标记包为已弃用

npm version <update_type>     # 更新版本号（patch/minor/major）
npm version patch             # 小版本更新（1.0.0 → 1.0.1）
npm version minor             # 中版本更新（1.0.0 → 1.1.0）
npm version major             # 大版本更新（1.0.0 → 2.0.0）

配置相关命令

bash 复制代码

npm config list               # 查看所有配置
npm config get <key>          # 查看特定配置
npm config set <key> <value>  # 设置配置
npm config delete <key>       # 删除配置

# 常用配置设置
npm config set registry https://registry.npmmirror.com  # 设置淘宝镜像
npm config set save-exact true          # 安装时保存精确版本号
npm config set save-prefix="~"          # 设置版本号前缀

缓存管理

bash 复制代码

npm cache verify              # 验证缓存完整性
npm cache clean --force       # 清理缓存
npm cache ls                  # 列出缓存内容

安全检查与修复

bash 复制代码

npm audit                     # 安全检查（显示漏洞）
npm audit fix                 # 自动修复漏洞
npm audit fix --force         # 强制修复（可能破坏兼容性）
npm audit --json              # 以 JSON 格式输出结果

npm fund                      # 查看项目依赖的资金信息

工作区命令（Monorepo）

bash 复制代码

npm init -w ./packages/<pkg>  # 创建工作区包
npm install -w <workspace>    # 为特定工作区安装依赖
npm run <script> -w <workspace> # 在特定工作区运行脚本

# 在工作区中操作所有包
npm run test --workspaces     # 在所有工作区运行 test 脚本
npm install --workspace=<pkg> # 为指定工作区安装

包检查与分析

bash 复制代码

npm ls                        # 依赖树查看
npm explain <package>         # 解释为什么安装了某个包

# 包大小分析
npm size <package>            # 查看包大小
npm pack --dry-run            # 模拟打包查看内容

# 许可证检查
npm licenses list             # 列出所有依赖的许可证

其他实用命令

bash 复制代码

npm root                      # 查看本地 node_modules 路径
npm root -g                   # 查看全局 node_modules 路径
npm bin                       # 查看本地可执行文件路径
npm bin -g                    # 查看全局可执行文件路径

npm dedupe                    # 减少重复依赖
npm prune                     # 移除无关的包
npm shrinkwrap                # 锁定依赖版本（旧版）
npm package-lock-only         # 只更新 package-lock.json

# 调试命令
npm --version                 # 查看 npm 版本
npm help <command>            # 查看命令帮助

常用组合命令示例

bash 复制代码

# 初始化并安装依赖
npm init -y && npm install

# 更新所有依赖到最新版本
npm install -g npm-check-updates && ncu -u && npm install

# 安全检查和修复
npm audit && npm audit fix

# 清理并重新安装
rm -rf node_modules package-lock.json && npm install

# 查看过时的包并选择性更新
npm outdated
npm update <specific-package>

# 设置淘宝镜像并安装
npm config set registry https://registry.npmmirror.com
npm install

环境变量和配置

bash 复制代码

# 临时使用镜像源
npm install --registry=https://registry.npmmirror.com

# 设置代理
npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080

# 设置超时时间
npm config set timeout 60000

这些命令覆盖了 npm 的日常使用场景，从基本的包管理到高级的发布和维护操作。根据你的具体需求选择合适的命令。