推荐用 Metals 进行 Scala 开发，需先安装 JDK 17+ 和 sbt/Mill，配置正确后支持补全、跳转、调试等；首次打开项目点击 Import build，修改 build.sbt 后需手动 Reload project。
用 VSCode 做 Scala 开发，推荐直接用 Metals——它是目前最成熟、与 Scala 生态（尤其是 sbt、Bloop、Mill）集成最好的语言服务器，支持代码补全、跳转、重构、调试（配合 Scala Debugger）、语义高亮等核心功能。关键在于配置要准，否则容易卡顿或功能失效。
安装前提：JDK 和构建工具
Metals 本身不处理编译，它依赖底层构建工具（如 sbt 或 Bloop）。所以必须先装好：
- JDK 11 或更高版本（推荐 JDK 17，Scala 3 项目更稳定）；确保
java -version和javac -version可用 - sbt（推荐 1.9.x+）或 Mill（0.11+），二者选其一即可；sbt 更通用，Mill 更轻量
- 如果用 sbt，建议在项目根目录的
project/plugins.sbt中添加：addSbtPlugin("ch.epfl.scala" % "sbt-bloop" % "1.5.12")（启用 Bloop 后端，提升 Metals 响应速度）
VSCode 插件安装与基础配置
打开 VSCode 扩展市场，搜索并安装：
- Metals（官方插件，由 Scala Center 维护）
- Scala Syntax Highlighting（增强语法高亮）
- 可选：Scala Debugger（用于断点调试，需配合
scala-cli或sbtpack生成可调试启动脚本）
安装后重启 VSCode，打开一个 Scala 项目根目录（含 build.sbt 或 build.sc），首次打开会弹出“Import build”提示，点击 Import build。Metals 会自动下载所需依赖、生成 BSP 连接配置，并索引源码。
常见问题与调优建议
导入失败或卡在 “Compiling…”？多数是环境或配置问题：
- 检查终端是否能正常运行
sbt compile或mill resolve；Metals 本质是复用你的构建命令 - 若项目含 Scala 3 和 Scala 2 混合模块，确保
build.sbt中各模块明确指定scalaVersion，避免 Metals 推断错误 - 大型项目响应慢？在 VSCode 设置中搜索
metals java home，手动指定 JDK 路径（避免 Metals 自动选错 JRE）；也可在.vscode/settings.json中加："metals.javaHome": "/path/to/jdk-17" - 补全不触发？确认光标在合法上下文（如
val x = List(1,2).|后按 Ctrl+Space），且文件已保存（Metals 默认只分析已保存文件）
进阶：调试与 REPL 集成
想边写边试？Metals 支持内置 Scala REPL：
- 按
Ctrl+Shift+P→ 输入Metals: Start REPL，启动后可在输出面板交互执行表达式 - 调试单测：右键点击
test目录下的 Scala 文件 →Debug Test；或点击测试方法左侧的 ▶️ 图标 - 调试主程序：需先在
run配置中指定主类，例如在.vscode/launch.json中添加：{"type": "scala","request": "launch","name": "Run Main","mainClass": "hello.World"}
不复杂但容易忽略：每次修改 build.sbt 后，记得右键点击编辑器内任意位置 → Metals: Reload project，否则新依赖不会被索引。
