Node.js 安装与环境配置实战指南

2. 设置 npm 配置

使用管理员身份打开 CMD（右键点击'命令提示符'选择'以管理员身份运行'），执行以下命令将前缀和缓存路径指向刚才创建的文件夹。注意替换为你实际的路径。

npm config set prefix "D:\common\develop\Nodejs\node_global"
npm config set cache "D:\common\develop\Nodejs\node_cache"

执行后可以通过 npm config get prefix 和 npm config get cache 确认配置是否生效。

3. 配置系统环境变量

1. 右键点击'此电脑' -> '属性' -> '高级系统设置' -> '环境变量'。
2. 在'系统变量'区域点击'新建'，变量名设为 NODE_PATH，变量值设为 D:\common\develop\Nodejs\node_global\node_modules。 *注：安装完 express 等模块后，该目录下会自动生成 node_modules 文件夹。
3. 在'用户变量'中找到 Path，双击编辑。将默认的 %AppData%\npm 路径修改为 D:\common\develop\Nodejs\node_global，或者在现有路径末尾追加新路径。
4. 在'系统变量'的 Path 中同样添加 %NODE_PATH%。
5. 依次点击确定保存所有设置。

测试安装

配置完成后，尝试全局安装一个常用模块来验证环境。推荐使用 Express 框架进行测试。

npm install express -g

如果看到类似以下的安装日志，说明配置成功。

常见问题： 如果没有使用管理员权限打开 CMD，可能会遇到权限错误。此时可以尝试以下两种解决方法：

1. 删除配置文件：在 C 盘用户目录下找到 .npmrc 文件并删除（注意不是安装目录下的）。
2. 修改文件夹权限：右键点击 node_global 和 node_cache 文件夹，进入'安全'选项卡，确保当前用户拥有完全控制权限。

配置国内镜像源

官方 npm 源在国内访问速度较慢，建议切换为淘宝镜像源以提升下载效率。

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

查看当前源地址：

npm config get registry

如果需要更便捷的体验，可以安装 cnpm（基于 npm 的淘宝定制版）：

npm install -g cnpm --registry=https://registry.npmmirror.com

验证安装：

cnpm -v

如果提示 cnpm 不是内部或外部命令，请检查之前的 prefix 和 cache 配置是否正确。若路径未生效，可先卸载再重新安装：

npm uninstall cnpm -g
npm install -g cnpm --registry=https://registry.npmmirror.com

故障排查清单

如果上述步骤仍有问题，请按以下顺序检查：

1. 检查命令输出：在 CMD 中输入 node -v 和 npm -v 确认版本信息正常显示。
2. 检查环境变量：确认用户变量和系统变量中的 Path 已包含 node_global 路径。
3. 检查目录结构：确认安装目录下存在 node_global 和 node_cache 文件夹，且 node_global 下应有 node_modules。

完成以上步骤后，你的 Node.js 开发环境应该已经准备就绪，可以开始构建应用了。