如何在Visual Studio Code中调试Scala代码？Metals插件异常怎么解决

你遇到的metals.doctor-run命令找不到报错，本质是Metals后台服务没有成功启动，按以下步骤排查即可：
你之前能用Run Code（Control+Alt+N）执行代码是调用的Code Runner扩展能力，和Metals无关，不代表Metals服务正常运行。

1. 确认打开的是项目根目录（最常见触发原因） #

Metals 仅支持识别标准 Scala 构建项目，不能单独打开单个.scala文件使用完整功能。你需要确保在VS Code中打开的是包含build.sbt文件的项目根文件夹，而非单独打开某一个代码文件。打开后等待1-2分钟，Metals会自动触发构建导入提示。

2. 升级JDK版本（核心兼容问题） #

你当前使用的JDK 8与安装的Metals v1.10.15版本不兼容，该版本Metals要求最低JDK 11及以上版本运行。你可以安装OpenJDK 11或更高的LTS版本（推荐11/17），配置好JAVA_HOME环境变量后重启VS Code即可。

3. 清理残留缓存后重启 #

仅重装扩展未清理缓存会导致旧错误残留，按以下步骤操作：

• 关闭VS Code，删除对应工作区的.metals、.bloop、.bsp隐藏文件夹
• 删除Metals全局缓存目录：~/.cache/metals
• 重新打开VS Code的项目根目录，等待Metals自动下载依赖完成初始化

4. 验证功能恢复 #

初始化完成后，你可以在命令面板执行Metals: Run doctor命令确认配置正常，代码透镜、F5调试、无调试运行功能都会自动恢复。

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