必须用nvm-windows管理多版本Node.js:先彻底卸载旧Node、清空环境变量和残留路径,再以管理员身份安装nvm,配置国内镜像源,最后通过nvm install/use/alias命令安装并切换版本。

要在Windows上同时维护多个Node.js项目,每个项目依赖不同版本的Node(比如一个用v14.21.3跑Vue2,另一个用v18.19.1跑Next.js 14),就必须避免直接安装Node.js——否则每次切换都要卸载重装,npm全局包会丢失,PATH路径反复污染,三天内至少重启终端五次。
彻底清理旧Node.js环境
这一步跳过会导致nvm后续所有命令失效,且错误提示不明确。必须手动清空三处:控制面板→卸载程序→删掉所有Node.js条目;删除C:\Program Files\nodejs和C:\Program Files (x86)\Nodejs(如果存在);打开系统环境变量→用户变量和系统变量里的PATH,逐条删掉含“nodejs”“npm”“NODE_PATH”的路径。
【重要前提】 打开CMD或PowerShell后执行node -v和npm -v,必须返回“不是内部或外部命令”,否则说明没清干净。
删完后重启电脑,确保任何终端窗口都未加载残留Node进程。
下载并以管理员身份运行nvm-setup.exe
访问GitHub官方发布页 https://github.com/coreybutler/nvm-windows/releases ,下载最新版nvm-setup.exe(当前为v1.1.12)。
右键该文件→选择“以管理员身份运行”,不能双击打开——否则安装后PATH不会写入系统变量,nvm命令在新终端里永远不可用。
安装向导中,nvm安装路径建议保持默认(C:\Users\你的用户名\AppData\Roaming\nvm),Node.js镜像目录设为C:\Program Files\nodejs——这个目录是nvm用来创建符号链接的,【不能含中文、空格或特殊字符】,否则后续install和use全部报Exit status 1。
验证安装并配置国内镜像源
安装完成后,必须关闭所有已打开的终端,重新打开一个新的CMD或PowerShell窗口。
输入nvm version,回车后显示1.1.12即成功。
若提示“nvm不是内部命令”,说明环境变量未生效,此时需手动检查系统PATH是否包含%NVM_HOME%和%NVM_SYMLINK%。
让 Windows 桌面程序在开机时静默自启并隐藏到系统托盘。特别适用于 Flutter、Electron 等无视 VBS/ProcessStartInfo 窗口样式、难以隐藏的顽固应用。提供「VBS 启动器 + Python ctypes/Win32 API」的隐藏窗口方案,可稳定把窗口收进托盘且不闪控制台。
为加速下载,在nvm安装目录下新建文本文件,命名为settings.txt,用记事本打开,粘贴以下两行:
node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/
安装与切换Node.js版本
第一步:查看可安装列表
nvm list available
第二步:安装LTS版本(稳定首选)
nvm install 18.19.1
第三步:安装较新版本用于测试
nvm install 20.12.0
第四步:查看已装版本
nvm list
第五步:切换到18.19.1并设为默认
nvm use 18.19.1 → nvm alias default 18.19.1
执行完nvm use后,立即在同个终端里运行node -v和npm -v,必须看到对应版本号。若仍显示旧版本或报错,请确认没在VS Code集成终端里操作——它会缓存旧PATH,应改用独立CMD窗口验证。










