NPM 常用操作指令大全

NPM（Node Package Manager）是 Node.js 默认的包管理工具，主要用于管理 JavaScript 项目的依赖包。以下是常用的 NPM 命令，涵盖安装、卸载、更新、查看等操作。

📌 1. NPM 初始化

npm init

• 逐步询问项目信息，并生成 package.json。
• 可使用 -y 跳过交互，直接生成默认配置：

npm init -y

📌 2. 安装依赖

🔹（1）安装单个依赖

npm install package-name

🔹 简写：

npm i package-name

示例：

npm i express

安装 express 并添加到 package.json 的 dependencies。

🔹（2）安装开发依赖

npm install package-name --save-dev

🔹 简写：

npm i package-name -D

示例：

npm i nodemon -D

仅在开发环境使用 nodemon。

🔹（3）全局安装

npm install package-name -g

示例：

npm i nodemon -g

在全局范围安装 nodemon，可在终端直接使用。

🔹（4）安装 package.json 中所有依赖

npm install

通常用于克隆项目后，自动安装所有依赖。

📌 3. 卸载依赖

🔹（1）卸载已安装的包

npm uninstall package-name

🔹 简写：

npm remove package-name

示例：

npm uninstall express

从 dependencies 中移除 express。

🔹（2）卸载开发依赖

npm uninstall package-name --save-dev

🔹 简写：

npm rm package-name -D

示例：

npm rm nodemon -D

从 devDependencies 中移除 nodemon。

🔹（3）全局卸载

npm uninstall package-name -g

示例：

npm uninstall nodemon -g

卸载全局安装的 nodemon。

📌 4. 更新依赖

🔹（1）更新单个依赖

npm update package-name

示例：

npm update lodash

更新 lodash 依赖。

🔹（2）更新所有依赖

npm update

更新 package.json 里所有的依赖。

🔹（3）更新到最新版本（可能引入不兼容变更）

npm install package-name@latest

示例：

npm i react@latest

安装最新的 react 版本。

📌 5. 查看信息

🔹（1）查看已安装的依赖

npm list

查看当前项目已安装的依赖及版本。

npm list -g --depth=0

查看全局已安装的 npm 包（仅显示顶级包）。

🔹（2）查看依赖信息

npm info package-name

示例：

npm info express

显示 express 包的详细信息。

📌 6. 清理 & 修复

🔹（1）清理缓存

npm cache clean --force

清除 npm 缓存，解决依赖安装问题。

🔹（2）修复 npm 权限问题

npm doctor

检测 npm 运行状态，修复可能的问题。

npm audit fix

自动修复安全漏洞。

📌 7. 版本管理

🔹（1）查看 NPM 版本

npm -v

查看本机安装的 npm 版本。

🔹（2）更新 NPM

npm install -g npm@latest

更新 npm 到最新版本。

🔹（3）切换 Node 版本（需安装 n）

npm install -g n
n stable

安装 Node.js 的最新稳定版。

📌 8. 运行脚本

🔹（1）运行 package.json 中定义的脚本

npm run script-name

示例：

{
  "scripts": {
    "start": "node index.js",
    "dev": "nodemon index.js"
  }
}

运行：

npm run start

或：

npm run dev

🔹（2）使用 npx 运行包

npx package-name

示例：

npx create-react-app my-app

使用 npx 运行 create-react-app（无需全局安装）。

📌 9. 版本号规则（SemVer）

NPM 版本号格式为 MAJOR.MINOR.PATCH：

• 1.0.0：主版本（MAJOR）变化，可能有不兼容变更。
• 1.1.0：次版本（MINOR）变化，新增功能，向后兼容。
• 1.1.1：补丁版本（PATCH）变化，修复 bug，向后兼容。

🔹（1）安装特定版本

npm install package-name@1.2.3

🔹（2）安装指定范围

npm install package-name@^1.2.0  # 允许 1.x 版本升级，但不超过 2.0.0
npm install package-name@~1.2.0  # 允许 1.2.x 版本升级，但不超过 1.3.0

📌 10. 切换 NPM 镜像

🔹（1）使用淘宝镜像

npm config set registry https://registry.npmmirror.com

切换 npm 源，提高安装速度。

🔹（2）恢复官方镜像

npm config set registry https://registry.npmjs.org

📌 总结

🚀 掌握这些常用命令，轻松管理 NPM 依赖！ 🎯