Windows系统下Node.js安装与npm全局路径缓存环境变量配置

脚本专家

Node.js 在现代前端工程化中承担包管理、构建工具、脚手架和 SSR/BFF 等角色，npm 依赖安装、Vite/Webpack/Rollup/esbuild、Vue CLI/Next.js/Nuxt 等均依赖其运行时。原文以 Windows 的 .msi 安装为例，给出从版本选择到 npm 全局路径、环境变量、镜像加速和常见报错的完整流程。下面按实际配置顺序重组关键命令与排错逻辑。

一、版本与安装选择
官网提供 LTS 和 Current 两类版本。LTS 稳定、经过充分测试并提供 30 个月长期维护，企业项目和生产环境优先；Current 含最新特性但可能有兼容性问题，适合尝鲜测试。Windows 选择 Installer(.msi)，安装包自带 npm，无需单独安装。安装路径尽量不要放在 C 盘，原文通过 Change 修改位置。安装过程中询问是否安装 Tools for Native Modules（C/C++ 编译工具）时，初学者不要勾选；只有使用 node-gyp 编译 bcrypt、node-canvas、部分 sharp 等原生 C++ 扩展时才需要。安装完成后在 PowerShell 验证：

2. node -v
3. npm -v

复制代码

原文示例输出为 v20.11.0 和 10.2.4，实际以安装版本为准。

二、为什么要调整 npm 全局目录
默认情况下，npm 全局包安装在 C:\Users\<用户名>\AppData\Roaming\npm，缓存在 C:\Users\<用户名>\.npm。全局包增多会占用 C 盘空间，某些操作还可能因权限不足报 EACCES。原文的做法是在 Node.js 安装目录下创建 node_global 和 node_cache 两个目录。以下路径需替换为你的实际安装路径：

2. D:\soft download\Nodejs\
3. ├── node_global\
4. ├── node_cache\
5. ├── node.exe
6. ├── npm.cmd
7. └── ...

复制代码

然后设置 npm 的 prefix 和 cache：

2. npm config set prefix "D:\soft download\Nodejs\node_global"
3. npm config set cache "D:\soft download\Nodejs\node_cache"

复制代码

验证：

2. npm config get prefix
3. npm config get cache

复制代码

这里配置的是 npm 全局包安装位置和下载缓存位置，不是 Node.js 可执行文件路径。后续 PATH 必须加入 node_global，否则 npm install -g 安装的命令行工具无法在终端直接调用。

三、PATH 与 NODE_PATH 配置
配置完 prefix 后，需要把 Node.js 安装路径和 node_global 加入系统变量 Path。原文步骤为：右键此电脑→属性→高级系统设置→环境变量，在系统变量 Path 中新建 D:\soft download\Nodejs\ 和 D:\soft download\Nodejs\node_global。用户变量 Path 中如果存在 C:\Users\<用户名>\AppData\Roaming\npm，要改为 D:\soft download\Nodejs\node_global，否则旧路径仍可能让全局命令指向 C 盘旧位置。接着新建系统变量 NODE_PATH，值为 D:\soft download\Nodejs\node_global\node_modules。NODE_PATH 的作用是让 require() 在常规 node_modules 查找之外也能引用全局模块；原文明确不推荐在生产代码中依赖这种做法，但调试时方便。保存后必须关闭并重新打开命令行窗口，环境变量变更才会生效。验证可执行：

2. npm install -g cnpm
3. cnpm -v

复制代码

若安装无报错且能输出版本，说明全局路径和环境变量基本配置成功。

四、npm 镜像加速
国内访问 npm 官方源较慢，可临时指定淘宝镜像：

2. npm install --registry=https://registry.npmmirror.com

复制代码

永久设置：

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

复制代码

验证：

2. npm config get registry

复制代码

镜像只影响包下载源，不改变全局包目录和 PATH 配置。

五、常见报错与定位
Q1：'npm' 不是内部或外部命令。通常是环境变量未配置或修改后未重开终端。检查系统变量 Path 是否包含 Node.js 安装路径，并重新打开命令行。
Q2：全局安装包后命令找不到。原因是 node_global 未加入系统变量 Path。把 node_global 路径加入 Path 后重开终端。
Q3：npm install 报 EACCES 权限错误。确认 npm config get prefix 指向自定义 node_global；可给该目录当前用户授予完全控制权限，或以管理员身份运行命令行。
Q4：安装速度极慢或超时。通常是仍使用官方源，按上文配置 registry.npmmirror.com。
Q5：npm ERR! code EJSONPARSE。package.json 格式错误，例如多逗号、少引号，使用 JSON 校验工具检查语法。
Q6：nvm 切换版本后 npm 失效。原文给出的处理是：

2. nvm use 20.11.0
3. npm install -g npm@latest

复制代码

然后重新检查 npm 是否可用。

整体来看，Node.js 安装本身不复杂，容易出问题的是 npm 全局目录、用户变量 PATH 旧路径和 NODE_PATH 的组合。按“安装验证→创建全局/缓存目录→npm config 设置→系统与用户 PATH→NODE_PATH→重开终端验证”的顺序执行，可以把大多数“命令找不到”和 EACCES 问题提前规避。