若VSCode中Scala语法高亮异常、补全缺失或跳转失效，需配置Metals：一、安装scalameta.metals扩展；二、确保有build.sbt等构建文件；三、执行Metals: Import build；四、将.scala文件语言模式设为Scala (Metals)；五、使用JDK 17+并配置metals.javaHome。
如果您在 Visual Studio Code 中使用 Scala 进行开发，但发现语法高亮异常、代码补全缺失或跳转定义失效，则可能是 Metals 语言服务器未正确配置或未启动。以下是启用并验证 Scala (Metals) 语言支持的具体操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Metals 扩展
Metals 是专为 Scala 设计的开源语言服务器，需通过 VSCode 扩展市场安装官方插件以提供核心功能。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X）。
2、在搜索框中输入 Metals，找到由 scalameta.metals 发布的官方扩展。
3、点击“安装”按钮，等待扩展下载并启用完成。
二、确保项目包含构建定义文件
Metals 依赖项目中的构建工具元数据（如 build.sbt 或 project/Build.scala）来解析依赖与源码结构，缺少这些文件将导致语言服务无法初始化。
1、在项目根目录下检查是否存在 build.sbt 文件。
2、若不存在，创建一个最小化文件，内容为：ThisBuild / scalaVersion := "2.13.14"。
3、保存后重新加载 VSCode 窗口（Cmd+Shift+P → 输入 “Developer: Reload Window”）。
三、手动触发 Metals 导入
当项目结构就绪后，VSCode 不会自动启动 Metals，需主动触发导入流程以生成 .bloop/ 和 .metals/ 配置目录。
1、按下 Cmd+Shift+P 打开命令面板。
2、输入 Metals: Import build 并回车。
3、观察右下角状态栏是否出现 Importing build… 提示，待其变为 Ready 即表示成功。
四、验证 Scala 文件识别状态
VSCode 需正确识别 .scala 文件为 Scala 语言类型，否则不会激活 Metals 提供的语义功能。
1、打开任意 .scala 文件，查看窗口右下角语言模式标识（如显示 “Plain Text”）。
2、点击该标识，弹出语言选择菜单。
3、输入 Scala 并选择对应项，确保状态栏显示为 Scala (Metals)。
五、检查 Java 运行时兼容性
Metals 本身是基于 JVM 的服务，要求系统中存在符合版本要求的 JDK，JDK 8 或 JDK 11 均不被支持，必须使用 JDK 17 或更高版本。
1、终端执行 java -version，确认输出中包含 17 或 21。
2、若版本不符，在 VSCode 设置中搜索 metals.javaHome。
3、点击“编辑设置 (JSON)”，添加键值对："metals.javaHome": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"。
