指令集-NPM 常用指令速查手册

文章描述： NPM (Node Package Manager) 是前端开发不可或缺的包管理工具。无论是引入第三方库、运行构建脚本，还是管理项目依赖版本，NPM 都扮演着核心角色。本文整理了 NPM 最常用的指令集，涵盖项目初始化、依赖管理、脚本执行、镜像源配置等高频场景。每条指令均附带实战示例，助你快速解决依赖问题，提升开发效率。

1. 项目初始化

生成配置文件

bash 复制代码

# 交互式创建 package.json
npm init
# 快速生成默认配置（跳过提问）
npm init -y

2. 依赖安装

基础安装

bash 复制代码

# 根据 package.json 安装所有依赖
npm install
# 简写
npm i
# 安装指定包（生产环境依赖）
npm install lodash
npm i lodash
# 安装指定版本
npm i vue@2.6.14

分类安装

bash 复制代码

# 安装开发环境依赖
npm install webpack --save-dev
# 简写
npm i webpack -D
# 安装生产环境依赖（默认行为）
npm i axios -S
# 全局安装（通常用于脚手架工具）
npm i -g typescript
npm i -g yarn

3. 依赖卸载与更新

卸载依赖

bash 复制代码

# 卸载项目依赖
npm uninstall lodash
# 卸载全局依赖
npm uninstall -g typescript

更新依赖

bash 复制代码

# 检查过时的包
npm outdated
# 更新指定包
npm update lodash
# 更新所有包（受 package.json 版本规则限制）
npm update

4. 脚本执行

运行脚本

bash 复制代码

# 运行 package.json 中的 scripts
npm run dev
npm run build
npm run serve
# 运行特殊脚本（可省略 run）
npm start
npm test

查看脚本列表

bash 复制代码

# 查看当前项目所有可用脚本
npm run

5. 查看与管理

查看信息

bash 复制代码

# 查看包的最新版本号
npm view vue version
# 查看包的所有历史版本
npm view vue versions
# 查看包的详细信息
npm view vue
# 查看全局安装路径
npm root -g
# 查看当前项目安装了哪些包
npm list --depth=0

检查与修复

bash 复制代码

# 扫描项目漏洞
npm audit
# 自动修复漏洞
npm audit fix

6. 镜像源管理

切换镜像源（解决下载慢）

bash 复制代码

# 查看当前镜像源
npm config get registry
# 临时指定镜像源安装
npm i lodash --registry=https://registry.npmmirror.com
# 永久切换为淘宝镜像
npm config set registry https://registry.npmmirror.com
# 切换回官方镜像
npm config set registry https://registry.npmjs.org/

清理缓存

bash 复制代码

# 强制清理 npm 缓存（解决安装报错）
npm cache clean --force

7. 版本号说明

语义化版本控制

复制代码

例如：1.2.3
主版本号.次版本号.修订号
^1.2.3：锁定主版本，允许次版本和修订号升级（最常用）
~1.2.3：锁定主版本和次版本，只允许修订号升级
1.2.3：精确安装指定版本，不升级

8. 常见故障排查流程

删依赖重装 ：

bash 复制代码

# 删除 node_modules 和 lock 文件重新安装
rm -rf node_modules package-lock.json
npm i

清缓存 ：
bash 复制代码
```
npm cache clean --force
```

查源：

bash 复制代码

# 如果下载失败，检查是否切回了官方源，建议切回淘宝源
npm config set registry https://registry.npmmirror.com