vscode运行scala需metals+构建链协同：必须装scala(metals)和sbt projects插件，确保jdk 17+、sbt可用且版本匹配build.sbt中显式声明scalaversion，删.metals/target后手动sbt compile验证，再import build；断点调试需正确配置launch.json并区分纯scala与spark本地模式。
VSCode 本身不直接“运行” Scala 代码，它靠 Metals 启动后台 sbt 进程来编译和执行——如果你点“运行”没反应、报错找不到主类或卡在 “Import build”，八成是构建链没通，不是插件装得少。
为什么 Metals: Import build 总是卡住或失败
导入失败不是网络慢导致的，而是本地工具链状态异常。Metals 启动时会 fork 一个独立的 sbt 进程，这个进程必须能干净地读取 build.sbt、下载依赖、生成 class 文件。任何一环断掉，都会表现为“无响应”或日志里反复出现 Failed to connect to build server。
- 删掉项目根目录下的
.metals和target目录（不是只清 VSCode 缓存） - 终端进项目根目录，手动跑
sbt compile；如果这步报错，Metals 必定失败，别跳过 - 检查
java -version输出是否含11.0.或17.0.——JDK 21 在 2026 年 4 月仍不被 Metals 官方 fully support - VSCode 设置中搜
metals.javaHome，必须填绝对路径，比如C:\Program Files\Java\jdk-17.0.2，不能留空或依赖系统 PATH
build.sbt 里不写这两行，Metals 就认不出 Scala 3
Scala 3 的 given、enum、inline 等语法不会被自动识别，不是插件问题，是 sbt 没告诉编译器用哪个语言版本。Metals 静态解析 build.sbt，不执行其中逻辑，所以动态写法（如 scalaVersion := sys.props.get("scala.version").getOrElse("3.3.3")）会被忽略。
- 必须显式写死：
ThisBuild / scalaVersion := "3.3.3"（不能写"3"或"3.3"） - 加一行：
ThisBuild / javacOptions ++= Seq("-source", "17", "-target", "17")，否则 JDK 17 编译出的 class 可能被误判为不兼容 - 避免混用 Scala 2 插件，比如删掉
addSbtPlugin("ch.epfl.scala" % "sbt-scala-module" % "...")这类只适配 2.x 的行
点 “Run this file with Metals” 却提示 No main class found
VSCode 不像 IntelliJ 那样自动扫描 object 里带 def main 的入口。它依赖 sbt 的 run 任务，而该任务只认 mainClass 配置或约定路径（src/main/scala 下的顶层 object）。裸文件、放错目录、没编译，都会触发这个错误。
- 确保文件路径是
src/main/scala/com/example/HelloWorld.scala，不是随便建个hello.scala放在根目录 - 文件内容必须是
object HelloWorld extends App { println("hi") }或带标准def main的写法 - 首次运行前，先手动触发一次
Metals: Import build，等状态栏显示Metals (ready)再试 - 右键菜单失效时，用命令面板
Ctrl+Shift+P→ 输入Metals: Run Worksheet，新建一个hello.worksheet.sc，里面直接写表达式就能实时看结果
最常被忽略的是：Metals 的语义分析完全依赖 sbt 构建产物，不是文件保存即生效。改了 build.sbt、换了 JDK、新增模块，都必须手动重导，而不是等它“自动更新”。
