Yarn dlx执行失败：Next.js项目VSCode SDK/doctor权限异常求助

可能的原因 #

• 个人配置目录下Temp文件夹权限不足：Yarn PnP生成VSCode SDK或运行yarn doctor时，需要读写临时文件，当前用户无该目录的读写权限，而yarn install和yarn dev使用的临时路径不同，因此未受影响。
• Yarn缓存或PnP存储损坏：虽然常规命令正常，但SDK生成、doctor检查对依赖完整性要求更高，缓存或PnP文件损坏可能触发权限类异常（如文件所有者不匹配）。
• VSCode运行权限不匹配：若VSCode以管理员/root身份运行，而项目或Temp目录所有者为普通用户，会导致跨权限访问失败；反之亦然。
• Yarn与Next.js版本兼容性问题：当前Yarn版本可能存在与Next.js 14.2.4 PnP模式相关的bug，导致特定命令触发权限错误。

解决思路 #

修复Temp文件夹权限 #

• 定位Temp目录：
  • Windows：C:\Users\<你的用户名>\AppData\Local\Temp
  • macOS：~/Library/Caches/Temp
  • Linux：/tmp 或 ~/.cache/temp
• 调整权限：
  • Windows：右键目录→属性→安全→编辑→添加当前用户，勾选「完全控制」
  • macOS/Linux：执行命令

    sudo chown -R $USER:$USER <Temp目录路径>
    chmod -R 755 <Temp目录路径>
    

清理Yarn缓存与PnP数据 #

1. 清理缓存：yarn cache clean
2. 删除项目根目录下的.pnp.cjs和.pnp.loader.mjs文件
3. 重新执行yarn install生成新的PnP配置
4. 再次尝试yarn dlx @yarnpkg/sdks vscode或yarn doctor

调整VSCode运行权限 #

• 若之前用管理员/root身份打开VSCode，关闭后以普通用户身份重启，再执行相关命令
• 若普通用户权限不足，可临时以管理员/root身份打开VSCode测试（不推荐长期使用）

调整Yarn版本 #

1. 查看当前版本：yarn --version
2. 升级到最新稳定版：yarn set version stable
3. 或降级到与Next.js 14.2.4兼容的稳定版本（如Yarn 4.2.2），再重新执行命令

检查项目目录权限 #

• 确保项目根目录所有者为当前用户，避免权限冲突
• macOS/Linux：chown -R $USER:$USER <项目目录路径>
• Windows：右键项目目录→属性→安全，确认当前用户有读写权限

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