npm命令大全

npm 命令大全

以下是 npm 的常用命令，适用于 macOS/Linux/Windows，作为 Node.js 的默认包管理器，功能全面且稳定。

1. 基础命令

安装依赖：

npm install  # 或 npm i，安装 package.json 中的所有依赖

添加依赖：

npm install <package>  # 安装并添加到 dependencies
npm install -D <package>  # 开发依赖（devDependencies）
npm install -g <package>  # 全局安装

移除依赖：

npm uninstall <package>  # 移除依赖

运行脚本：

npm run <script>  # 执行 package.json 中的脚本

2. 项目管理

初始化项目：

npm init  # 创建 package.json（加 -y 可跳过交互）

更新依赖：

npm update  # 更新所有依赖到最新兼容版
npm update <package>  # 更新特定包

列出依赖：

npm list  # 或 npm ls，列出当前项目依赖
npm list -g  # 列出全局依赖

3. 缓存管理

缓存位置：
- 默认：
  - macOS/Linux：~/.npm
  - Windows：%APPDATA%\npm-cache（通常是 C:\Users\你的用户名\AppData\Roaming\npm-cache）
- 说明：npm 将下载的包缓存到这里，用于加速重复安装。

查找缓存路径：

npm config get cache  # 显示当前缓存路径

检查缓存内容：

ls -la ~/.npm  # macOS/Linux
dir "%APPDATA%\npm-cache"  # Windows (PowerShell)

清理缓存：

npm cache clean  # 清理部分缓存
npm cache clean --force  # 强制清空所有缓存

验证缓存：

npm cache verify  # 检查缓存完整性并修复问题

4. 配置管理

查看配置：

npm config get <key>  # 查看某项配置，如 cache

设置配置：

npm config set <key> <value>  # 设置配置
# 示例：
npm config set cache ~/.npm  # 指定缓存路径
npm config set registry https://registry.npmjs.org/  # 设置镜像

编辑配置文件：

npm config edit  # 打开全局配置文件（~/.npmrc）

5. 其他实用命令

查看版本：

npm --version  # 或 npm -v，显示 npm 版本

强制重新安装：

npm install --force  # 忽略缓存，重新安装

执行特定版本工具：

npm exec <command>  # 在项目环境下运行命令（7.x+）
# 示例：
npm exec node --version

发布包：
```
npm publish  # 发布到 npm 仓库
```

6. 注意事项

权限修复（如缓存目录不可写）：

sudo chmod -R u+rw ~/.npm  # macOS/Linux

网络问题（下载失败时）：

npm config set registry https://registry.npmjs.org/  # 切换官方镜像

全局安装路径：
- macOS/Linux：/usr/local/lib/node_modules
- Windows：%APPDATA%\npm\node_modules
- 查看：npm config get prefix

示例：快速上手

npm init -y                 # 创建新项目
npm install @heroicons/react # 安装依赖
npm config get cache        # 检查缓存位置
npm run dev                 # 运行开发脚本
npm cache clean --force     # 清理缓存

与 pnpm 的对比

缓存：npm 每个项目独立复制依赖，缓存仅加速下载；pnpm 用全局存储+符号链接，节省空间。
速度：npm 较慢，pnpm 更快。
命令：大部分相似，但 pnpm 用 add 替代 install <package>。