windows 11 上有六种 node.js 安装方式:一、官网 msi 直装(自动配 path);二、nvm-windows(多版本管理);三、zip 免安装+手动配环境变量;四、winget 命令行安装;五、wsl2 linux 环境安装;六、docker 容器化安装。

如果您需要在 Windows 11 系统上搭建 JavaScript 运行环境以进行开发或运行基于 Node.js 的应用程序,但尚未完成安装与基础配置,则可能面临命令不可识别、全局模块无法调用或 npm 安装缓慢等问题。以下是六种相互独立、可单独实施的 Node.js 安装与设置方式:
一、官网 MSI 安装包直装(含自动 PATH 配置)
该方式利用官方提供的 Windows Installer (.msi) 包,在安装过程中自动写入系统环境变量,适合零配置经验的新手用户,无需手动编辑 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 的冗余下载,直接点击 Next。
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 确认当前版本生效。
三、ZIP 免安装版 + 手动配置环境变量
该方式使用官方提供的预编译 ZIP 包,不执行安装流程,完全由用户自主控制解压位置与环境变量设置,适用于对系统变更敏感或受限于管理员权限的场景。
1、访问 https://nodejs.org/dist/,下载最新 LTS 版本的 win-x64.zip(如 node-v20.18.0-win-x64.zip)。
2、解压 ZIP 文件至目标路径(如 D:\app\nodejs-zip),确保路径不含空格与中文字符。
3、以管理员身份打开命令提示符,执行以下命令验证可执行性:D:\app\nodejs-zip\node.exe -v。
4、右键“此电脑”→“属性”→“高级系统设置”→“环境变量”,在【系统变量】中找到 Path,点击“编辑”后新增一行:D:\app\nodejs-zip。
5、新建系统变量 NODE_PATH,值设为:D:\app\nodejs-zip\node_modules。
6、重启命令提示符,直接输入 node -v 和 npm -v 验证是否识别。
四、winget 命令行工具一键安装
该方式利用 Windows 11 内置的现代包管理器 winget,通过终端指令完成部署,全程无需浏览器交互,适合批量配置或自动化脚本集成。
1、按下 Win + X,选择“终端(管理员)”打开高级权限窗口。
2、执行命令检查 winget 是否启用:winget --version;若未安装,请先从 Microsoft Store 安装 App Installer。
3、执行搜索命令定位官方包:winget search Node.js,确认返回结果中包含 OpenJS.NodeJS 条目。
4、执行安装命令:winget install --id=OpenJS.NodeJS --source winget。
5、安装完成后关闭并重新打开终端,运行 node --version 与 npm --version 进行验证。
五、WSL2 Linux 原生环境安装
该方式在 Windows 11 中启用 WSL2 子系统,于 Ubuntu 或 Debian 等发行版内安装 Node.js,获得完整类 Unix 开发体验,适用于需严格匹配生产部署环境的场景。
1、以管理员身份运行 PowerShell,依次执行启用命令:wsl --install,系统将自动启用虚拟机平台、Windows Subsystem for Linux 及默认发行版(Ubuntu)。
2、重启系统后启动 Ubuntu,完成初始用户设置。
3、在 Ubuntu 终端中更新软件源:sudo apt update && sudo apt upgrade -y。
4、添加 NodeSource 仓库并安装 LTS 版本:curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - && sudo apt-get install -y nodejs。
5、验证安装:node -v 和 npm -v,输出应显示版本号。
6、如需在 Windows 命令行中调用,可使用 wsl node -v 或配置 alias。
六、Docker 容器化隔离安装
该方式通过 Docker 运行 Node.js 官方镜像,实现环境完全隔离、版本按需拉取、项目依赖互不干扰,适用于 CI/CD 流水线或微服务本地调试。
1、确保已安装 Docker Desktop for Windows,并启用 WSL2 后端,启动 Docker 服务。
2、打开 PowerShell 或 CMD,执行镜像拉取命令:docker pull node:lts。
3、运行临时容器验证基础功能:docker run --rm -it node:lts node -v,应输出 Node.js 版本。
4、挂载本地项目目录并进入交互式环境:docker run --rm -it -v ${PWD}:/workspace -w /workspace node:lts /bin/bash。
5、在容器内执行 npm init -y 或 npm install express 等操作,所有依赖仅存在于容器生命周期内。
6、退出容器后,本地文件系统不受影响,再次运行相同命令将重建干净环境。











