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 [email protected]
🔹 (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 init -y
|
| 安装依赖 | npm i package-name
|
| 安装开发依赖 | npm i package-name -D
|
| 全局安装 | npm i package-name -g
|
| 卸载依赖 | npm uninstall package-name
|
| 更新依赖 | npm update package-name
|
| 查看已安装依赖 | npm list
|
| 清理缓存 | npm cache clean --force
|
| 运行脚本 | npm run script-name
|
🚀 掌握这些常用命令,轻松管理 NPM 依赖! 🎯