Node.js 是前端开发和 AI 智能体（如 Claude Code）运行的必备环境。很多同学安装时只是“一路 Next”，结果导致：

1. C 盘空间爆炸：所有依赖包默认都装在 C 盘。
2. 下载速度慢：没配置国内镜像源，下个包要半天。
3. 权限报错：全局安装模块时经常报 EACCES 错误。

这篇教程将基于 Windows 11 系统，手把手带大家完成 Node.js 的下载、安装、环境变量配置以及淘宝镜像加速。

第一步：下载 Node.js

首先去官网下载最新且稳定的版本。

1. 访问官网：打开 Node.js 官方网站
2. 版本选择：推荐下载左侧的 LTS (Long Term Support) 版本。LTS 是长期支持版，最稳定，适合工作和生产环境；右侧的 Current 是尝鲜版，bug 相对较多。

第二步：安装步骤 (关键配置)

下载好 .msi 安装包后，双击运行。

1. 欢迎界面：点击 Next。

1、许可协议：勾选 “I accept…“，点击 Next。

2、选择安装路径 (建议修改)：

• 默认路径是 C:\Program Files\nodejs\。
• 强烈建议：为了不占用 C 盘空间，建议修改到 D 盘或 E 盘。例如：D:\software\nodejs\。
• 修改好后点击 Next。

3、自定义安装：保持默认即可，直接点击 Next。

4、Tools for Native Modules：这个界面不要勾选（除非你需要编译 C++ 模块），否则它会给你自动下载几个 G 的 VS Build Tools 和 Python，非常慢。直接点击 Next。

5、安装：点击 Install，等待进度条走完，点击 Finish。

第三步：验证安装

按下 Win + R 键，输入 cmd 打开命令提示符，分别输入以下命令检查版本：

node -vnpm -v

 第四步：环境配置 (核心步骤)

这一步最重要！我们要把 npm 全局安装的包和缓存文件，也从 C 盘迁移到我们刚才安装的目录下，方便管理。

1. ### 创建文件夹

打开你的 Node.js 安装目录（例如 D:\software\nodejs），手动新建两个文件夹：

• node_global
• node_cache

2. ### 执行配置命令

在 CMD 窗口中，依次执行以下两条命令（注意替换成你自己的实际路径）：

npm config set prefix "D:\software\nodejs\node_global"
npm config set cache "D:\software\nodejs\node_cache"

3. ### 配置环境变量

如果不配置这个，以后你用 npm install -g 安装的工具（比如 vue, claude-code）都会提示“找不到命令”。

1. 在桌面右键“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
2. 修改【系统变量】中的 Path：
   1. 找到 Path 变量，点击“编辑”。
   2. 检查是否有默认的 C 盘 npm 路径，如果有，删除它。
   3. 新建一条，填入你的 Node.js 安装路径：D:\software\nodejs\。

4.新建/修改【用户变量】中的 Path：

1. 在【用户变量】里找到 Path，点击“编辑”。
2. 将默认的 C:\Users\用户名\AppData\Roaming\npm修改为：D:\software\nodejs\node_global。
3. 如果没有，就新建一条。

5.新建 NODE_PATH 变量：

1. 在【系统变量】区域，点击“新建”。
2. 变量名：NODE_PATH
3. 变量值：D:\software\nodejs\node_global\node_modules
4. 点击确定保存所有窗口。

第五步：配置国内镜像源 (提速)

默认的 npm 源在国外，下载速度很慢。我们配置淘宝最新的镜像源。 在 CMD 中输入：

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

验证是否配置成功：

npm config get registry

如果返回 https://registry.npmmirror.com/，说明提速成功！

第六步：修改文件夹权限

1. 打开文件资源管理器，找到您的安装目录：D:\software。
2. 右键点击nodejs 文件夹，选择 “属性” (Properties)。
3. 点击顶部的 “安全” (Security) 选项卡。
4. 点击中间的 “编辑” (Edit) 按钮。
5. 在“组或用户名”列表中，选中 Users（也就是普通用户组）。
6. 在下方的“Users 的权限”里，勾选“完全控制” (Full control) 这一行的“允许”框。
7. 点击 “确定”，再点击 “确定”。

1、如果出现以下错误提示：（如果没出现提示则跳过此步骤）

核心原因是：安装程序在尝试修改文件夹 D:\software\node\corepack 的权限时，遇到了文件占用或权限不足的问题。

虽然提示错误，但只要程序文件已经复制完毕，通常不影响 Node.js 的正常使用。不过点击“继续”后，残留的权限问题可能会导致后续在全局安装 npm 包时出错。

可以按照以下步骤修复：

方法：手动释放权限

如果点击继续后，后续安装包报错 "EACCES" 或 "EPERM"，说明权限确实被锁死了，需要手动修复：

1. 关闭所有程序：确保关闭了 VS Code、终端、资源管理器等可能占用 node 文件夹的程序。

2. 以管理员身份打开命令提示符：

   • 按 Win + S，输入 cmd。

   • 右键点击“命令提示符”，选择 “以管理员身份运行”。

3. 获取文件夹所有权：
   在黑色窗口中输入以下命令并回车（注意替换为你实际的 Node.js 安装路径）：

   cmd

   takeown /f "D:\software\node" /r /d y

4. 重置文件夹权限：
   上一步完成后，继续输入：

   cmd

   icacls "D:\software\node" /reset /t /c /q

5. 等待命令执行完毕，出现“已成功处理”的提示后，关闭窗口。以后再安装或更新就不会出现这个弹窗了。

 第七步：最终测试

为了确保一切配置完美，我们试着安装一个常用的全局模块（比如 express 或 vue）。 输入命令：

npm install express -g

安装完成后，去你的 D:\Environment\nodejs\node_global\node_modules 目录下看看，如果看到了 express 文件夹，说明所有配置大功告成！🎉