vscode不直接运行scala代码，需metals启动sbt进程编译执行；import build卡住主因是本地工具链异常，须删.metals/target、手动sbt compile验证、确保jdk 17+且metals.javahome设绝对路径、build.sbt显式写死scalaversion := "3.3.3"、文件置于src/main/scala下并命名匹配object。
VSCode 本身不运行 Scala 代码，它靠 Metals 启动后台 sbt 进程来编译和执行——如果你点“运行”没反应、报错 No main class found 或卡在 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输出是否含17.0.——JDK 21 在 2026 年 6 月仍不被 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方法 - 文件名要和
object名一致，比如App.scala里写object App - 右键文件 → 选
Run this file with Metals，它会自动推导mainClass并启动 JVM
最常被忽略的是：改完 build.sbt 后不手动触发 Metals: Import build，就以为配置生效了；还有就是把 .scala 文件直接放在项目根目录下，而不是 src/main/scala/ 子目录里——这两处看似微小，却足以让整个流程静默失败。
