使用 winget 安装
# 安装官方 LTS 版本
winget install OpenJS.NodeJS.LTS
# 安装特定的版本
winget install OpenJS.NodeJS.LTS --version 24.18.0
# 安装完成后,重启终端并输入 node -v 和 npm -v 验证是否成功
使用安装包安装
使用 https://nodejs.org/zh-cn/about/previous-releases 或者 Node.js 官方网站(https://nodejs.org/)下载 Windows 安装包(.msi)。
认准 LTS 版本:强烈建议选择 LTS(Long Term Support,长期支持版),其版本号为偶数(如 v20、v22、v24)。该版本稳定性高,适合生产环境和绝大多数开发者;右侧的 Current 版本为奇数,包含最新特性但不够稳定,仅适合尝鲜。
安装步骤
-
修改安装路径:默认路径为
C:/Program Files/nodejs。为了防止占用 C 盘空间,建议点击 Change 将其修改到其他盘。注意:路径中绝对不能包含中文或空格。 -
取消编译工具勾选:在自定义安装界面,若出现
Tools for Native Modules选项,初学者请勿勾选。否则安装程序会自动下载体积庞大的VS Build Tools和Python,极其耗时。后续若有C++模块编译需求再按需安装即可。保持其余选项默认,点击Install完成安装。
验证安装
按下 Win + R 键,输入 cmd 打开命令提示符,分别输入node -v 和 npm -v
配置系统环境变量
为了让系统识别新的全局模块位置,必须配置环境变量,否则后续全局安装的工具会提示“找不到命令”:
右键“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
修改用户变量:在【用户变量】中找到 Path,将默认的 C:/Users/用户名/AppData/Roaming/npm 修改为 D:/software/nodejs/node_global。
新建系统变量:在【系统变量】中点击“新建”,变量名设为 NODE_PATH,变量值设为 D:/software/nodejs/node_global/node_modules。
配置国内镜像源(提速下载)
npm 默认使用国外源,下载速度较慢。建议切换为淘宝镜像源:
在 CMD 中输入以下命令:
npm config set registry https://registry.npmmirror.com
验证是否生效:
npm config get registry
若返回 https://registry.npmmirror.com/,则说明镜像配置成功,后续下载依赖速度将大幅提升。