Windows 10下D盘使用pnpm安装包出现ERR_PNPM_SYMLINK_FAILED错误求助

问题描述 #

在Windows 10专业版系统中，执行pnpm i express（或其他任意包）时，仅D盘会触发ERR_PNPM_SYMLINK_FAILED错误，其他盘符可正常操作。完整错误信息如下：

/d/server $ pnpm i express
Packages: +62
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 ERR_PNPM_SYMLINK_FAILED  Error: UNKNOWN: unknown error, symlink 'D:\server\node_modules\.pnpm\accepts@1.3.8\node_modules\accepts\' -> 'D:\server\node_modules\.pnpm\express@4.18.2\nodmodules\.pnpm\accepts@1.3.8\node_modules\accepts\' -> 'D:\server\node_modules\.pnpm\express@4.18.2\node_modules\accepts'
Progress: resolved 62, reused 0, downloaded 62, added 19
/d/server $

这是全新安装的Windows系统，此前使用Linux Mint作为日常开发系统。已尝试删除D盘下旧的.pnpm-store目录，但问题未解决。

可能的原因及解决办法 #

1. D盘文件系统或符号链接权限问题 #

Windows下pnpm依赖符号链接管理包依赖，若D盘不支持符号链接或权限未开放，会导致创建失败：

• 检查D盘格式：右键D盘→属性，确认文件系统为NTFS。若为FAT32，需备份数据后格式化为NTFS。
• 启用全类型符号链接评估：
  1. 按下Win+X，选择「Windows PowerShell(管理员)」。
  2. 执行命令：fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1，启用所有类型的符号链接支持。

2. 修改pnpm链接模式绕过符号链接 #

强制pnpm使用硬链接或直接复制文件，避免符号链接问题：

• 临时生效：执行安装命令时添加参数：pnpm i express --link-mode=hardlink（或--link-mode=copy，复制文件占用更多磁盘但更稳定）。
• 永久生效：在用户目录下创建/修改.pnpmrc文件，添加link-mode=hardlink配置项。

3. 检查D盘项目目录权限 #

确保当前用户对D盘的项目文件夹有完全控制权限：

• 右键项目文件夹→属性→安全→编辑→选择当前用户→勾选「完全控制」→应用并确认。

4. 排查安全软件拦截 #

部分杀毒软件或Windows Defender会阻止符号链接创建：

• 临时关闭Windows Defender实时保护或第三方杀毒软件，重新执行pnpm i测试，测试完成后恢复防护。

5. 清理并重建pnpm全局存储 #

执行以下命令清理全局存储后重新安装：

pnpm store prune

回到D盘项目目录，重新执行pnpm install。

内容的提问来源于stack exchange，提问作者Kazi Shariful Islam