配置VSCode中Scala开发环境需安装JDK 8/11、sbt和VSCode，再通过扩展市场安装Scala Center的Metals插件，打开含build.sbt的项目后导入构建，即可使用代码补全、跳转定义、查找引用、重构及错误提示等功能；若遇问题可尝试删除.metal、target等目录或检查Java版本与网络。
配置 VSCode 中的 Scala 开发环境，特别是针对 sbt 项目并使用 Metals（金属服务器）作为语言服务器，是目前 Scala 社区推荐的标准方式。Metals 提供代码补全、跳转定义、查找引用、重构、错误提示等现代 IDE 功能，配合 VSCode 使用体验流畅。
安装必要组件
要成功运行 Metals，需确保系统中已安装以下基础工具：
- Java 运行环境（JDK 8 或 11）：Metals 基于 JVM 运行，必须安装 JDK。推荐使用 Temurin（原 AdoptOpenJDK）或 OpenJDK 发行版。
- sbt：Scala 的标准构建工具。可通过官网或包管理器（如 Homebrew、SDKMAN!）安装。
- VSCode：从官网下载并安装最新版 Visual Studio Code。
java -version 和 sbt --version 确认安装成功。
安装 Metals 扩展
打开 VSCode，进入扩展市场（快捷键 Ctrl+Shift+X），搜索 “Metals” 并安装由 Scala Center 官方维护的插件。
- 扩展名称：Scala (Metals)
- 作者：Scala Center
安装完成后，重启 VSCode。当你打开一个 sbt 项目（即包含 build.sbt 文件的目录）时，Metals 会自动检测并提示导入项目。
导入 sbt 项目
将 VSCode 打开到你的 Scala 项目根目录（该目录应包含 build.sbt 文件）。
- 首次打开时，VSCode 会弹出通知：“Import build?”，点击 Import build。
- Metals 会调用 sbt 后台进程分析依赖、编译结构和源码位置。
- 导入成功后，状态栏会出现 “Metals: Ready” 提示。
若未自动提示，可手动触发：按下 Ctrl+Shift+P，输入 “Metals: Import Build”，回车执行。
常用功能与设置
Metals 导入成功后，即可享受以下功能：
- 语法高亮与错误提示：保存文件时自动检查编译错误。
- 跳转到定义：F12 或右键选择 “Go to Definition”。
- 查找引用：Alt+F12 查看某符号被使用的位置。
- 代码补全：输入时自动提示方法、字段和导入建议。
- 快速修复：红色波浪线下按 Alt+Enter 获取修复建议（如自动导入缺失类）。
- 运行测试：在测试文件中点击 “Run Test” 按钮直接执行。
你可以在 VSCode 设置中调整 Metals 行为，例如启用“自动导入构建”或设置 JVM 参数：
设置路径：VSCode → 设置 → 搜索 “Metals”常见问题处理
遇到问题时可参考以下建议：
-
导入卡住或失败：关闭项目，删除
.metals/和project/project/、target/目录后重试。 -
无法解析依赖：确认网络正常，或尝试在终端运行
sbt compile检查是否能编译通过。 - Java 版本不兼容：某些旧版 Scala 项目不支持 JDK 17+，建议使用 JDK 8 或 11。
- 没有导入提示：手动执行 “Metals: Restart Server” 或 “Metals: Connect to Build Server”。
