Metals插件配置成功需完成五步：安装启用插件、安装Java与sbt、运行sbt metalsEnable生成BSP配置、设置.vscode/settings.json指定JDK路径、执行Metals: Import build触发连接。
如果您在vscode中进行scala开发，但无法获得代码补全、跳转定义或编译错误提示，则可能是metals插件未正确配置或底层服务未启动。以下是完成metals插件配置的具体步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装并启用Metals插件
Metals是专为Scala设计的语言服务器，需通过VSCode扩展市场安装官方插件以启用语言功能支持。
1、打开VSCode，点击左侧活动栏的扩展图标（或按快捷键Ctrl+Shift+X）。
2、在搜索框中输入Metals，找到由Scala Center发布的官方扩展。
3、点击“安装”按钮，安装完成后点击“重新加载”使插件生效。
二、确保系统已安装Java与sbt
Metals依赖JVM运行环境及构建工具sbt来解析项目结构和启动语言服务器。
1、在终端执行java -version，确认输出包含Java 11或Java 17版本信息。
2、执行sbt --version，验证sbt是否已安装；若未安装，使用Homebrew运行brew install sbt。
3、检查环境变量PATH中是否包含sbt可执行路径，必要时在~/.zshrc中添加export PATH="$HOME/bin:$PATH"并执行source命令刷新。
三、初始化Scala项目并生成BSP配置
Metals需通过构建服务器协议（BSP）与项目通信，因此必须在项目根目录下生成.bsp/子目录及对应元数据文件。
1、进入您的Scala项目根目录，在终端中运行sbt metalsEnable。
2、等待sbt完成编译并输出[info] Successfully generated BSP configuration提示。
3、确认项目根目录下已创建.bsp/metals.json与target/scala-*/classes/等路径。
四、配置VSCode工作区设置
通过修改.vscode/settings.json可覆盖全局行为，确保Metals识别正确的Scala版本与JDK路径。
1、在项目根目录下新建文件夹.vscode，并在其中创建settings.json。
2、写入以下内容：
3、将"metals.javaHome"字段值设为本地JDK路径，例如"/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"。
4、保存文件后，重启VSCode窗口或执行命令面板中的Developer: Reload Window。
五、手动触发Metals连接与导入
当项目未自动触发导入时，可通过命令面板强制启动Metals会话并建立BSP连接。
1、按下Cmd+Shift+P（macOS）打开命令面板。
2、输入并选择Metals: Import build。
3、观察右下角状态栏出现Compiling library definitions...提示，表示正在加载标准库索引。
4、待状态栏显示Connected to Build Server且无红色错误图标时，即表示配置成功。
