Skip to main content

常用命令

npm 常用命令大全​

npm（Node Package Manager）是 JavaScript 生态中最流行的包管理工具，掌握其核心命令能显著提升开发效率。以下是根据使用场景分类的常用命令清单：

一、基础项目操作​

1. 初始化项目​

npm init        # 交互式创建 package.json
npm init -y     # 使用默认配置快速创建

2. 安装依赖​

npm install <package>          # 安装并添加到 dependencies
npm install -D <package>       # 安装并添加到 devDependencies
npm install -g <package>       # 全局安装
npm install -S      # 精确版本安装（不使用 ^ 或 ~）

3. 卸载依赖​

npm uninstall <package>        # 从 dependencies 卸载
npm uninstall -D <package>     # 从 devDependencies 卸载
npm uninstall -g <package>     # 全局卸载

4. 更新依赖​

npm update                # 更新所有依赖（遵循版本约束）
npm update <package>      # 更新单个包
npm outdated              # 查看可更新的依赖

二、项目开发与运行​

1. 执行脚本​

npm run <script>          # 执行 package.json 中的脚本
npm start                 # 等价于 npm run start
npm test                  # 等价于 npm run test

2. 查看包信息​

npm info <package>        # 查看包详情（版本、依赖等）
npm list                  # 列出当前项目依赖树
npm list -g               # 列出全局安装的包

3. 清理缓存​

npm cache clean --force   # 强制清理 npm 缓存

三、高级依赖管理​

1. 锁定依赖版本​

npm ci                    # 基于 package-lock.json 精确安装依赖
npm shrinkwrap            # 生成 npm-shrinkwrap.json（类似 package-lock）

2. 包版本控制​

npm version <update_type> # 更新 package.json 版本号
                          # <update_type>: patch/minor/major
npm view <package> versions # 查看包的所有可用版本

3. 依赖分析​

npm audit                 # 检查依赖安全漏洞
npm audit fix             # 自动修复安全漏洞

四、全局与配置​

1. 全局命令​

npm root -g               # 查看全局模块安装路径
npm bin -g                # 查看全局命令路径

2. 配置管理​

npm config list           # 查看所有配置
npm config get <key>      # 获取单个配置
npm config set <key> <value> # 设置配置
npm config delete <key>   # 删除配置

3. 切换镜像源​

npm config set registry https://registry.npmmirror.com # 切换到淘宝镜像
npm config set registry https://registry.npmjs.org     # 切换回官方

五、发布与分享​

1. 包发布​

npm login                 # 登录 npm 账号
npm publish               # 发布包
npm unpublish <package>@<version> # 取消发布（需在 72 小时内且未被依赖）

2. 包链接（开发阶段）​

npm link                  # 在包目录创建全局链接
npm link <package>        # 在项目中链接全局包
npm unlink <package>      # 取消链接

六、脚本与生命周期​

1. 常用内置脚本​

npm install    # 安装依赖后执行（postinstall）
npm test       # 运行测试
npm start      # 启动应用
npm stop       # 停止应用
npm restart    # 重启应用（先 stop 再 start）

2. 自定义脚本​

在 package.json 中添加：

"scripts": {
  "build": "webpack --config webpack.config.js",
  "dev": "webpack-dev-server",
  "lint": "eslint src"
}

执行：

npm run build
npm run dev
npm run lint

七、实用技巧​

1. 快速查看包文档​

npm docs <package>        # 打开包文档页面
npm home <package>        # 打开包主页

2. 快速创建临时项目​

npx create-react-app my-app # 使用 npx 执行包命令（无需安装）

3. 检查命令来自哪个包​

npm which <command>       # 查看命令路径

八、npm vs npx vs yarn​

工具特点
npmNode.js 官方包管理器，功能全面，支持 lock 文件和工作空间。
npxnpm 5.2+ 内置的工具，用于执行一次性命令（无需全局安装）。
yarnFacebook 推出的高性能包管理器，支持离线模式和确定性安装。
yarn v2更现代的包管理方案，支持零安装和 Plug’n’Play。

九、常见问题与解决方案​

  1. 依赖安装缓慢

    • 切换镜像源：npm config set registry https://registry.npmmirror.com
    • 使用 cnpm 或 yarn 替代

  2. 权限问题（全局安装）

    • 避免使用 sudo：修改 npm 全局路径权限 
      mkdir ~/.npm-global
      npm config set prefix '~/.npm-global'
      export PATH=~/.npm-global/bin:$PATH

  3. 版本冲突

    • 使用 npm ls <package> 查看冲突
    • 使用 npm dedupe 合并重复依赖
    • 手动调整 package.json 中的版本约束

掌握这些命令后，你可以高效管理项目依赖、开发流程和发布部署。建议结合官方文档（https://docs.npmjs.com/）深入学习特定命令的参数和用法。