配置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 文件）。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 首次打开时，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”。

基本上就这些。配置一次后，后续项目通常能自动识别。Metals 对 sbt 项目支持良好，是当前最轻量且功能完整的 Scala 开发方案。