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 依赖! 🎯