Win10 如何安装Node.js

Windows 10 安装 Node.js 应选 LTS 版、自定义安装路径（ 如D:\Develop\nodejs\ ）、勾选 npm 和 Add to PATH；需重定向 npm 全局路径至 node_global 、手动添加该路径到系统 PATH，并配置淘宝镜像源加速。

如果您在 Windows 10系统上尝试安装 Node.js 但遇到版本选择混乱、环境变量失效或全局模块路径占用 C 盘空间等问题，则很可能是安装路径、npm 配置或系统 PATH 未正确设置所致。以下是针对 Win10 平台的完整安装与设置操作步骤：

一、下载并安装 Node.js LTS 版本

选择 LTS（ 长期支持 ）版本可确保稳定性与兼容性，避免因使用 Current 版导致项目构建失败或依赖异常。该版本已内置 npm，无需单独安装。

1、访问 Node.js 中文官网 https://nodejs.org/zh-cn/download/，确认页面显示“ LTS ”标签的最新稳定版（ 如 v20.15.1 或更高 LTS 编号 ）。

2、根据系统架构选择对应安装包：若为 64 位 Win10，下载  Windows Installer (.msi) 64-bit ；若不确定，右键“ 此电脑 ”→“ 属性 ”，查看“ 系统类型 ”。

3、双击运行下载的 .msi 文件，勾选  I accept the terms in the License Agreement ，点击“ Next ”。

4、在安装路径页，点击“ Change… ”按钮，将默认 C:\Program Files\nodejs\ 修改为非系统盘路径，例如 D:\Develop\nodejs\，以规避重装系统时开发环境丢失风险。

5、在“Custom Setup”页，确保勾选 npm package manager 和 Add to PATH 两项，其余保持默认，连续点击“Next”直至完成安装。

二、验证基础安装是否成功

通过命令行检测Node.js与npm是否被系统识别，是后续所有配置的前提。若任一命令返回“不是内部或外部命令”，说明PATH未生效或安装异常。

1、按 Win + R 输入 cmd，回车打开命令提示符。

2、输入 node -v 并回车，确认输出类似 v20.15.1 的版本号。

3、输入 npm -v 并回车，确认输出类似 10.7.0 的npm版本号。

4、若任一命令报错，请关闭所有命令行窗口，重新以管理员身份运行cmd，再执行上述验证。

三、重定向npm全局模块与缓存路径

默认情况下，npm全局安装（-g）的模块会写入 C:\Users\{用户名}\AppData\Roaming\npm，持续占用系统盘空间且易受用户权限策略干扰。将其迁移至Node.js安装目录下可统一管理并规避权限问题。

1、在Node.js安装目录（如 D:\Develop\nodejs\）中新建两个空文件夹：node_global 和 node_cache。

2、以管理员身份打开cmd，依次执行以下两条命令（注意路径需与实际一致，引号不可省略）：

npm config set prefix “D:\Develop\nodejs\node_global”

npm config set cache “D:\Develop\nodejs\node_cache”

3、执行 npm config get prefix 与 npm config get cache，确认输出路径与上步所设完全一致。

四、手动添加npm全局路径到系统环境变量

即使安装时勾选了“Add to PATH”，npm全局模块的可执行文件（如npx、create-react-app等）仍需额外将 node_global 路径加入系统PATH，否则命令行无法直接调用。

1、右键“此电脑”→“属性”→“高级系统设置”→“环境变量”。

2、在“系统变量”区域找到并双击 Path。

3、点击“新建”，粘贴 D:\Develop\nodejs\node_global（请严格匹配您创建的实际路径）。

4、点击“确定”逐级保存，关闭所有环境变量窗口。

5、**重启所有已打开的命令行窗口**，再执行 npm list -g –depth=0 验证全局模块是否可被识别。

五、配置国内镜像源加速 npm 操作

默认npm registry位于境外，国内用户常面临超时、卡顿或安装失败。切换至淘宝NPM镜像（registry.npmmirror.com）可显著提升模块安装与更新速度，且完全兼容原生npm协议。

1、在 cmd 中执行以下命令，永久设置镜像源：

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

2、执行 npm config get registry，确认返回值为 https://registry.npmmirror.com。

3、如需临时切换回官方源，可执行 npm config set registry https://registry.npmjs.org。

4、为验证镜像有效性，可运行 npm install -g cnpm –registry=https://registry.npmmirror.com 安装cnpm客户端作为备用工具。