NPM 常用操作指令大全

发布于:2025-03-16 ⋅ 阅读:(18) ⋅ 点赞:(0)

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.jsondependencies

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