Node.js全局包与npm缓存迁移D盘及环境变量排错

脚本专家

将 Node.js 的全局包和 npm 缓存从默认 C 盘迁到 D 盘，适合 C 盘空间紧张、需要集中管理全局 CLI 工具，或准备安装 Claude Code 等 npm 全局包的环境。该方案只调整 npm 的 prefix 和 cache，不改变 Node.js 本体安装位置；若要把 Node.js 本体也迁到 D 盘，需要在安装时自定义路径，原文不涉及。

【安装与目录准备】
从 Node.js 官网下载 LTS 版本的 .msi 安装包，双击安装时可保持默认选项，安装路径留在 C 盘不影响后续配置。随后打开 CMD 或 PowerShell，创建 D 盘专用目录：

2. mkdir D:\software\nodejs\node_global
3. mkdir D:\software\nodejs\node_cache

复制代码

如果 mkdir 报权限错误，可先执行 D: 切换盘符再重试。Windows 原生支持 mkdir。

【配置 npm 全局路径】
分别设置全局包安装目录和缓存目录：

2. npm config set prefix D:/software/nodejs/node_global
3. npm config set cache D:/software/nodejs/node_cache

复制代码

其中 prefix 决定 npm 全局包的安装位置，cache 决定 npm 缓存位置。Windows 下路径可使用正斜杠 / 或双反斜杠 \\，避免单反斜杠被转义。配置后先验证：

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

复制代码

预期输出应为：

2. D:\software\nodejs\node_global
3. D:\software\nodejs\node_cache

复制代码

【配置系统环境变量】
按 Win + R 输入 sysdm.cpl，进入“高级”选项卡，点击“环境变量”。在“系统变量”区域找到 Path，双击后新建两项：

2. D:\software\nodejs\node_global
3. D:\software\nodejs\node_global\node_modules

复制代码

还可选新建系统变量 NODE_PATH，变量值为：

2. D:\software\nodejs\node_global\node_modules

复制代码

依次点击“确定”保存所有窗口。Path 用于让全局命令可被系统找到，NODE_PATH 为可选配置。环境变量修改后需要重启终端才能生效。

【重启终端并最终验证】
关闭所有已打开的 CMD/PowerShell 窗口，重新打开一个新的 CMD，执行：

2. npm root -g

复制代码

预期输出：

2. D:\software\nodejs\node_global\node_modules

复制代码

【常见问题排查】
如果 npm config get prefix 仍显示旧路径，检查 %USERPROFILE%\\.npmrc 文件，可手动写入 prefix=D:\software\nodejs\node_global。如果 npm root -g 仍显示 C 盘路径，确认系统 Path 环境变量中已添加 D:\software\nodejs\node_global，并重启终端。如果 mkdir 命令报错，先确认权限，必要时执行 D: 切换盘符后重试。

【后续用途】
迁移完成后，可通过 npm install -g <包名> 安装任意全局 CLI 工具，全局包会安装到 D 盘。例如安装 Claude Code：

2. npm install -g @anthropic-ai/claude-code

复制代码

该方案不改变 Node.js 程序本体安装位置，仅迁移全局包和缓存目录。若需完全迁移 Node.js 本体，应在安装时选择自定义安装路径，影响范围更大，原文方案不涉及。