VS Code安装Metals 0.11.6版本提示下载失败如何排查解决

问题背景 #

此前Metals扩展可正常安装使用，近期安装时触发下载失败报错，已确认配置的JDK路径完全正确，报错反复出现，报错原文如下：

Failed to download Metals, make sure you have an internet connection, the Metals version '0.11.6' is correct and the Java Home 'C:\Program Files\Java\jdk-11.0.14' is valid. You can configure the Metals version and Java Home in the settings. HTTP proxy相关配置可参考代理设置指引。

排查解决步骤 #

按优先级从高到低依次操作即可，不需要全试：

• 清理损坏的本地Metals缓存
  正常使用后突发安装失败，90%以上的原因是旧版本缓存文件损坏、读写权限异常。先完全退出所有VS Code进程，打开Windows资源管理器进入路径C:\Users\你的当前系统用户名\.metals，直接删除该目录下所有内容（不会影响项目代码，重启扩展后会自动重新拉取所需文件），再重新打开VS Code触发Metals安装流程。
• 对齐VS Code代理配置
  系统代理能正常联网不代表VS Code内代理配置生效：打开VS Code设置面板，搜索http.proxy配置项，确认配置值和你当前使用的代理地址、端口完全匹配；如果没有使用代理，确保该项留空，同时把http.proxyStrictSSL设置为false，避免本地网络证书校验异常阻断下载。
• 验证JDK实际运行权限
  路径正确不代表JDK可被VS Code正常调用：按下Win+R输入cmd打开命令提示符，直接执行命令"C:\Program Files\Java\jdk-11.0.14\bin\java.exe" -version，确认能正常输出版本信息。如果之前曾用管理员权限启动过VS Code，生成的缓存文件会带有高权限标记，普通权限启动时会出现读写失败被误判为JDK无效，清空缓存后固定用普通权限启动VS Code即可解决。
• 手动指定Metals服务端版本
  自动版本拉取接口异常也会报下载失败：打开Metals扩展设置，找到Metals: Server Version选项，不要使用默认的自动匹配版本，手动选择列表里不带SNAPSHOT标记的最新稳定版，保存设置后重启VS Code重新触发下载。
• 排查安全软件拦截
  部分杀毒、终端安全软件更新规则后，会误将Metals服务端文件识别为风险程序拦截写入，可以临时关闭安全软件实时防护后重试安装，如果安装成功，把C:\Users\你的用户名\.metals目录加入安全软件白名单即可。

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