【软件安装和环境配置】Node.js D 盘安装完整方案

Node.js D 盘安装方案（Windows）

适用场景

将 Node.js 的全局包和缓存目录迁移至 D 盘，避免占用 C 盘空间，并为后续安装 CLI 工具（如 Claude Code）做准备。

---

操作步骤

1. 下载安装 Node.js

• 访问官网：https://nodejs.org/zh-cn/download/current
• 下载 LTS 版本 的 .msi 安装包
• 双击安装，全程保持默认选项（安装路径可保持 C 盘默认，不影响后续配置）

---

2. 创建 D 盘专用目录

打开 CMD 或 PowerShell，逐条执行：

mkdir D:\software\nodejs\node_global
mkdir D:\software\nodejs\node_cache

---

3. 配置 npm 全局路径

依次执行：

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

注意：Windows 下可用正斜杠 / 或双反斜杠 \\，避免单反斜杠被转义。

---

4. 验证配置是否生效

执行：

npm config get prefix
npm config get cache

预期输出：

• D:\software\nodejs\node_global
• D:\software\nodejs\node_cache

---

5. 配置系统环境变量（永久生效）

1. 按 Win + R，输入 sysdm.cpl，回车

2. 切换到 "高级" 选项卡 → 点击 "环境变量"

3. 在 "系统变量" 区域：

   • 找到 Path，双击 → 点击 "新建" ，添加：

     D:\software\nodejs\node_global

   • 再次点击 "新建" ，添加：

     D:\software\nodejs\node_global\node_modules

4. （可选）点击 "新建" 系统变量：

   • 变量名：NODE_PATH
   • 变量值：D:\software\nodejs\node_global\node_modules

5. 依次点击"确定"保存所有窗口

---

6. 重启终端并最终验证

• 关闭所有已打开的 CMD/PowerShell 窗口
• 重新打开一个新的 CMD 窗口，执行：

npm root -g

预期输出：

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 命令报错	Windows 原生支持 mkdir，若权限不足先执行 D: 切换盘符再重试

---

后续用途

此方案完成后，即可通过以下命令安装任意全局 CLI 工具（均安装至 D 盘）：

npm install -g <包名>

例如安装 Claude Code：

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

---

备注

• 本方案不改变 Node.js 程序本体安装位置（仍在 C 盘），仅迁移全局包和缓存目录
• 如需完全迁移 Node.js 本体至 D 盘，需在安装时选择自定义安装路径，但影响范围更大，本方案不涉及