如何修复 Windows 版 NVM 的 `NVM_SYMLINK` 激活错误

关注「索引目录」公众号，获取更多干货。

如果您在使用Windows 版 NVM时看到以下错误：

nvm enabled activation error:
NVM_SYMLINK is set to a physical file/directory at C:\Program Files\nodejs
Please remove the location and try again,
or select a different location for NVM_SYMLINK.

你并不孤单。这是从传统的Node.js安装方式切换到NVM时常见的问题。

本指南解释了根本原因，并提供了有保障的逐步修复方案。

为什么会出现这种错误

使用官方 Windows 安装程序安装 Node.js 时，会创建以下目录：

C:\Program Files\nodejs

但是，Windows 版 NVM使用此相同路径作为符号链接（NVM_SYMLINK）来动态切换 Node 版本。

如果物理目录已存在于该位置，NVM 无法覆盖它，激活将失败。

逐步修复（保证有效）

步骤 1：关闭所有与 Node 相关的应用程序

在进行更改之前：

• 关闭所有终端窗口
• 关闭 VS Code 或任何 IDE
• 停止所有正在运行的 Node.js 应用程序

这样可以避免文件锁定问题。

步骤 2：以管理员身份打开命令提示符

1. 按下开始键
2. 类型cmd
3. 右键单击 →以管理员身份运行

由于我们要进行修改，因此需要管理员权限Program Files。

步骤 3：获取目录所有权

由于 TrustedInstaller 的权限限制，Windows 可能会阻止删除操作。

跑步：

takeown /f "C:\Program Files\nodejs" /r /d y

然后授予完全权限：

icacls "C:\Program Files\nodejs" /grant %username%:F /t

步骤四：终止所有正在运行的Node进程

taskkill /f /im node.exe
taskkill /f /im npm.exe

这样可以确保没有进程锁定文件。

步骤 5：删除现有节点目录

rmdir /s /q "C:\Program Files\nodejs"

命令标志详解：

• /s
  → 删除所有子目录和文件
• /q
  → 抑制确认提示

仍然显示“访问被拒绝”？

以管理员身份打开PowerShell并运行：

Remove-Item "C:\Program Files\nodejs" -Recurse -Force

备用方法（如果文件被锁定）

如果目录仍然无法删除：

1. 重启系统
2. 请勿打开任何应用程序
3. 立即以管理员身份打开命令提示符
4. 跑步：

rmdir /s /q "C:\Program Files\nodejs"

这样可以解决大多数后台文件锁定问题。

重新启用 NVM

目录删除后：

nvm on

然后安装并激活Node版本：

nvm install 18
nvm use 18
node -v

现在您应该可以看到已安装的Node版本。

迁移到 NVM 的最佳实践

如果您要从直接安装 Node.js 切换到 NVM：

1. 首先从控制面板卸载 Node.js。
2. 手动确认C:\Program Files\nodejs已删除
3. 然后安装并配置NVM

这样就完全避免了激活冲突。

最后想说的话

出现此错误的原因是 NVM 依赖于符号链接，而 Windows 不允许它覆盖现有的物理目录。

按照以上步骤操作，即可NVM_SYMLINK在大多数 Windows 环境下彻底解决激活错误。

关注「索引目录」公众号，获取更多干货。