Windows 下最稳妥的 Node.js 多版本管理:fnm

一、 核心配置(只需执行一次)

  1. 安装 fnm打开 PowerShell 运行:winget install Schniz.fnm

  2. 解锁脚本权限(解决无法加载文件报错)以管理员身份打开 PowerShell 运行:Set-ExecutionPolicy RemoteSigned -Scope CurrentUser(弹出提示输入 Y 回车)

  3. 配置文件挂载(解决 node 命令找不到的问题)在 PowerShell 中运行以下命令强行创建并打开配置文件:if (!(Test-Path $PROFILE)) { New-Item -Type File -Path $PROFILE -Force }; notepad $PROFILE

在打开的记事本末尾,另起一行粘贴以下代码,保存并关闭:fnm env --use-on-cd | Out-String | Invoke-Expression

二、 fnm 常用命令(重启终端生效)

  • 查看 fnm 版本(注意:必须是大写 V):fnm -V

  • 安装 Node 20 稳定版:fnm install 20

  • 设置全局默认版本为 Node 20:fnm default 20

  • 查看本地已安装的版本:fnm list

  • 查看云端可下载的版本:fnm list-remote

  • 临时在当前窗口切换版本:fnm use 20

  • 卸载指定版本:fnm uninstall 18.x.x

三、 终极验证

全部配置完成后,重新打开 PowerShell 输入:node -v(正确输出 v20.x.x 即表示大功告成)

四、 额外优化(解决 Windows 路径过长报错) 以管理员身份打开 PowerShell 运行:New-ItemProperty -Path "HKLM:\System\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -PropertyType DWORD -Force