运行VSCode源码执行yarn时出现ripgrep下载失败如何解决

优先方案（官方修复版适配） #

• 同步拉取VSCode官方仓库的最新源码，主分支已默认升级修复了该问题的vscode-ripgrep版本，同步代码后重新执行yarn即可。
• 若不想同步全量代码，可手动修改package.json中的vscode-ripgrep依赖版本，将"vscode-ripgrep": "^1.12.1"升级至已修复问题的更高版本（如1.14.2及以上）。
• 依次执行以下命令清理旧缓存与锁文件：

  del yarn.lock
  yarn cache clean vscode-ripgrep
  

• 手动删除报错提示中对应的本地临时ripgrep缓存目录，格式为C:\Users\你的用户名\AppData\Local\Temp\vscode-ripgrep-cache-xxx。
• 重新执行yarn安装依赖即可。

备用方案（离线缓存绕过） #

如果网络环境限制无法正常拉取新版本依赖，可采用手动缓存的方式绕过下载逻辑：

• 自行搜索下载与报错提示中版本对应的ripgrep预编译压缩包，对应系统为windows x64 msys版本。
• 将下载好的zip包放入上述临时缓存目录，若目录不存在可手动新建。
• 重新执行yarn，安装程序检测到已存在对应缓存包将直接读取，不会触发下载流程。

临时调试方案 #

如果仅需要本地调试VSCode核心功能不需要使用ripgrep相关能力，可通过环境变量跳过下载：

• 本地提前安装ripgrep并将其添加到系统环境变量PATH中。
• 执行yarn前在当前powershell窗口执行：

  $env:RIPGREP_BINARY = "system"
  

• 再执行yarn即可直接调用本地已安装的ripgrep，跳过下载步骤。

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