全新Windows11系统运行pnpm install报ERR_PNPM_LINKING_FAILED错误求助

以下是针对该问题的针对性解决方案，按优先级尝试：

• 临时关闭Windows Defender实时保护
  Windows Defender的实时扫描可能会锁定pnpm操作的文件，导致重命名权限失败。临时关闭实时保护后运行pnpm install，完成后记得重新开启。也可以把项目目录添加到Defender的排除列表，避免后续重复触发。

• 调整pnpm的链接/存储策略
  pnpm默认的硬链接模式在Windows系统目录下容易触发权限问题，试试这些配置：

  • 指定非系统盘的存储目录：pnpm config set store-dir D:\pnpm-store
  • 禁用工作区包链接，强制复制：pnpm config set link-workspace-packages false
  • 临时使用hoist模式安装：pnpm install --shamefully-hoist

• 重新配置Node.js安装路径
  把Node.js安装到非系统盘（比如D:\Node.js），避免系统目录的严格权限限制。安装时确保勾选“Add to PATH”，并设置全局包目录到非系统盘：npm config set prefix D:\npm-global

• 关闭占用项目文件的程序
  检查VS Code、文件资源管理器等是否打开了项目目录或其中的文件，这些程序可能锁定文件导致重命名失败。关闭相关程序后再执行pnpm install。也可以用Process Explorer搜索项目目录相关进程，结束占用的进程。

• 重置pnpm环境
  清理pnpm存储并重置配置：

  1. 运行pnpm store prune清理本地存储
  2. 删除项目下的pnpm-lock.yaml和node_modules文件夹
  3. 执行pnpm config delete all重置配置
  4. 重新运行pnpm install

内容的提问来源于stack exchange，提问作者Joram