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且无红色错误图标时，即表示配置成功。

# java  # vscode  # js  # json  # macbook  # 工具  # mac  # macos  # 环境变量  # win  # 编译错误  # cos