Windows下npm命令如何正确使用？

安装Node.js与npm

1. 下载Node.js安装包
   访问Node.js官网下载LTS版本（长期支持版）,双击运行安装程序。
2. 安装选项配置
   • 勾选 Add to PATH（关键步骤，否则无法全局使用npm命令）
   • 默认安装包含 npm包管理器（安装Node.js后自动附带）。
3. 验证安装
   打开命令提示符（CMD）或PowerShell，输入：

   node -v  # 显示Node.js版本
   npm -v   # 显示npm版本

   若返回版本号（如v18.12.1和5.0）,表示安装成功。

核心npm命令详解

初始化项目

npm init        # 交互式创建package.json文件
npm init -y     # 跳过问答，直接生成默认配置

安装依赖包

npm install lodash              # 安装最新版到当前目录的node_modules
npm install express@4.18.2      # 安装指定版本
npm install -g typescript       # 全局安装（适用于命令行工具）

管理依赖类型

更新与卸载

npm update axios       # 更新指定包
npm uninstall vue      # 卸载本地包
npm list -g --depth=0  # 查看全局安装的包

运行项目脚本

在package.json中配置脚本：

{
  "scripts": {
    "start": "node app.js",
    "build": "webpack"
  }
}

执行脚本：

npm run build  # 运行自定义脚本
npm start      # 启动应用（start/test可省略run）

Windows特有问题解决方案

权限错误（Error: EPERM）

• 原因：Windows权限限制。
• 解决：
  以管理员身份运行CMD/PowerShell，或执行：

  npm install --global --production windows-build-tools

命令未识别（’npm’ is not recognized）

• 原因：Node.js未加入系统路径。
• 解决：
  1. 卸载Node.js后重新安装，务必勾选Add to PATH
  2. 手动添加路径（默认路径）：
     C:\Program Files\nodejs\ 到系统环境变量Path中。

全局包路径问题

• 查看全局安装路径：

  npm config get prefix

• 修改默认全局路径（避免C盘占用）：

  npm config set prefix "D:\nodejs\global"

  并添加此路径到系统Path环境变量。

最佳实践建议

1. 使用nvm管理Node版本
   安装nvm-windows，切换多版本Node.js：

   nvm install 18.12.1  # 安装指定版本
   nvm use 18.12.1      # 切换版本

2. 镜像加速
   配置国内镜像提升下载速度：

   npm config set registry https://registry.npmmirror.com

3. 安全审计
   定期检查依赖漏洞：

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

常见问题速查

• npm卡顿或无响应：
  清除缓存：npm cache clean --force
  升级npm：npm install -g npm@latest
• 项目依赖冲突：
  删除node_modules和package-lock.json，重新执行npm install。
• 脚本执行错误：
  检查package.json中脚本命令的路径是否准确。

引用说明： 参考Node.js官方文档、npm官方文档、Microsoft Windows支持指南及开发者社区实践案例，所有操作均在Windows 10/11环境中验证通过,遵循MIT开源协议与最佳安全实践。