在 windows 11 上安装 node.js 有五种方式:一、官网 msi 直装(自动配置 path,适合新手);二、nvm-windows(支持多版本切换);三、powershell 静默安装(批量部署);四、chocolatey 安装(已配包管理器场景);五、配置 npm 全局路径与国内镜像源(推荐补充)。

如果您在 Windows 11 系统上需要运行 JavaScript 后端代码或前端构建工具,则必须先安装 Node.js 运行时环境。以下是适用于 Win11 的多种可靠安装方式,覆盖新手入门与进阶开发者需求。
一、官网 MSI 安装包直装(含自动 PATH 配置)
该方式使用官方提供的 Windows Installer (.msi) 包,在安装过程中自动将 Node.js 和 npm 添加至系统环境变量 PATH,无需手动编辑,适合零配置经验的新手用户。
1、访问 Node.js 官方网站 https://nodejs.org/en/download,页面自动识别 Win11 系统,点击 LTS Recommended For Most Users 下方的 Windows Installer (.msi) 64-bit 按钮下载。
2、双击运行下载的 .msi 文件,点击 Next 进入许可协议界面。
3、勾选 I accept the terms in the License Agreement,点击 Next。
4、点击 Change 按钮,将安装路径修改为非系统盘路径(如 D:\software\nodejs),确保路径为纯英文、无空格、无中文。
5、在 Custom Setup 页面,确认 Add to PATH 已勾选,其余选项保持默认,点击 Next。
6、在 Tools for Native Modules 页面,不勾选任何选项,避免触发 VS BuildTools 和 Python 的冗余下载。
7、点击 Install 开始安装,进度完成后点击 Finish。
8、按 Win + R 输入 cmd,执行 node -v 和 npm -v,输出版本号即表示成功。
二、nvm-windows 版本管理器安装(支持多版本共存)
该方式通过 nvm-windows 实现 Node.js 多版本并行安装与快速切换,适用于需适配不同项目 Node 版本要求的开发者,可彻底规避全局版本冲突问题。
1、卸载系统中已存在的 Node.js 和 npm(控制面板 → 卸载程序 → 删除所有 Node.js 相关条目)。
2、访问 nvm-windows 官方 GitHub 发布页 https://github.com/coreybutler/nvm-windows/releases,下载最新 nvm-setup.zip 并解压运行安装程序。
3、安装时指定 nvm 安装路径(如 C:\nvm),同时指定 nodejs 存储根目录(如 D:\nvm\nodejs)。
4、安装完成后重启命令行,执行 nvm version 验证 nvm 是否就绪。
5、执行 nvm list available 查看可安装版本列表,选择 LTS 版本(如 20.18.0)。
6、执行 nvm install 20.18.0 安装指定版本,再执行 nvm use 20.18.0 激活。
7、执行 node -v 和 npm -v 确认当前版本生效。
三、PowerShell 脚本静默安装(适用于批量部署)
该方式通过 PowerShell 调用官方 MSI 包执行无人值守安装,适用于企业 IT 管理员或需在多台 Win11 设备上统一部署的场景,全程无需图形界面交互。
1、以管理员身份打开 PowerShell,执行以下命令下载最新 LTS 版本 MSI 安装包:
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求,未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
Invoke-WebRequest -Uri "https://nodejs.org/dist/v20.18.0/node-v20.18.0-x64.msi" -OutFile "$env:TEMP\nodejs.msi"
2、执行静默安装命令,指定安装路径并跳过用户交互:
msiexec /i "$env:TEMP\nodejs.msi" INSTALLDIR="D:\software\nodejs" ADDLOCAL=NodeFeatureMain,NodeFeatureNpm,NodeFeaturePath /qn
3、等待命令执行完成,无报错即表示安装结束。
4、新开 PowerShell 窗口,执行 node -v 和 npm -v 验证安装结果。
四、Chocolatey 包管理器安装(适用于已有 Chocolatey 环境)
该方式利用 Windows 原生包管理器 Chocolatey 快速安装 Node.js,支持版本锁定与依赖自动解析,适合已配置 Chocolatey 的开发环境或 CI/CD 流水线。
1、确认已安装 Chocolatey:在管理员 PowerShell 中执行 choco --version,有版本号输出即就绪。
2、执行命令安装 Node.js LTS 版本:
choco install nodejs-lts --force -y
3、安装过程自动处理 PATH 注册与权限配置,无需额外操作。
4、执行 node -v 和 npm -v 验证安装结果。
五、配置 npm 全局路径与镜像源(推荐补充步骤)
该步骤将 npm 全局安装目录和缓存目录从默认 C 盘迁移至自定义路径,并切换为国内镜像源,避免磁盘空间占用与网络超时问题。
1、在 Node.js 安装目录下(如 D:\software\nodejs)新建两个文件夹:node_global 和 node_cache。
2、以管理员身份打开命令提示符,依次执行以下命令:
npm config set prefix "D:\software\nodejs\node_global"
npm config set cache "D:\software\nodejs\node_cache"
3、执行 npm config set registry https://registry.npmmirror.com 切换为国内镜像源。
4、执行 npm config get registry 确认镜像源已变更。
5、编辑系统环境变量,将 D:\software\nodejs\node_global 添加至 Path 变量中。










