Metals 是专为 Scala 设计的语言服务器，需通过 VSCode 官方插件安装，并配置 Java 17 环境、导入含 build.sbt 的项目后，方可启用代码补全、跳转定义和实时错误提示等功能。

如果您在 Visual Studio Code 中开发 Scala 项目，但无法获得代码补全、跳转定义或编译错误实时提示，则很可能是缺少语言服务器支持。Metals 是专为 Scala 设计的开源语言服务器，需通过插件方式集成到 VSCode 中。以下是完成安装与基础使用的具体步骤：

本文运行环境：MacBook Air，macOS Sequoia。

一、安装 Metals 官方插件

VSCode 通过扩展市场提供官方维护的 Metals 插件，该插件负责启动 Metals 语言服务器并桥接编辑器功能。安装后无需手动下载 JAR 包，插件会自动处理依赖和版本适配。

1、打开 VSCode，点击左侧活动栏最下方的扩展图标（四个方块组成的图标）。

2、在扩展搜索框中输入 Metals，找到由 scalameta.metals 发布的官方插件。

3、点击“安装”按钮，等待状态变为“已安装”。

二、配置 Java 运行时环境

Metals 服务本身基于 JVM 构建，必须依赖本地已安装的 Java 11 或 Java 17 运行时。VSCode 不会自动检测 Java 路径，需手动指定以避免启动失败。

1、确认系统已安装 Java 17：在终端执行 java -version，输出应包含 17.x.x。

2、打开 VSCode 设置（Cmd + ,），搜索 metals java home。

3、在“Metals: Java Home”设置项中，点击“编辑设置（settings.json）”，添加键值对："metals.javaHome": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"（路径需按实际 JDK 安装位置调整）。

三、导入 Scala 项目

Metals 需要识别构建工具元数据（如 build.sbt 或 build.sc）才能启动语言服务器并索引源码。仅打开 .scala 文件不会触发自动导入，必须显式执行导入操作。

1、在 VSCode 中通过“文件 → 打开文件夹”加载含 build.sbt 的 Scala 项目根目录。

2、底部状态栏出现 Import build 提示时，点击该文字。

3、选择 Import build，等待右下角通知显示 Import completed successfully。

四、验证核心功能是否启用

导入成功后，Metals 将启动语义分析并建立符号索引。此时可立即测试关键编辑能力，确认服务正常响应。

1、在任意 .scala 文件中右键点击一个类名，选择 Go to Definition，应跳转至源码声明处。

2、将光标悬停在函数调用上，数秒后应显示 Scaladoc 注释与签名信息。

3、在未定义变量处输入代码，编辑器应即时标红并显示 Type mismatch 类型错误提示。

# java  # vscode  # js  # json  # go  # macbook  # 工具  # mac  # ai  # macos  # 编译错误  # cos  # 键值对 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： Laravel如何创建和注册中间件_Laravel中间件编写与应用流程  ,交易猫的商品怎么发布到网站上去？  Python3.6正式版新特性预览  Laravel怎么做缓存_Laravel Cache系统提升应用速度的策略与技巧  如何用好域名打造高点击率的自主建站？  如何在IIS管理器中快速创建并配置网站？  JavaScript模板引擎Template.js使用详解  Laravel如何实现一对一模型关联？（Eloquent示例）  JS中对数组元素进行增删改移的方法总结  uc浏览器二维码扫描入口_uc浏览器扫码功能使用地址  绝密ChatGPT指令：手把手教你生成HR无法拒绝的求职信  Laravel如何将应用部署到生产服务器_Laravel生产环境部署流程  使用spring连接及操作mongodb3.0实例  如何在Windows虚拟主机上快速搭建网站？  如何用狗爹虚拟主机快速搭建网站？  香港服务器租用每月最低只需15元？  哪家制作企业网站好,开办像阿里巴巴那样的网络公司和网站要怎么做？  如何快速建站并高效导出源代码？  Android中Textview和图片同行显示(文字超出用省略号，图片自动靠右边)  胶州企业网站制作公司,青岛石头网络科技有限公司怎么样？  Laravel如何集成Inertia.js与Vue/React？（安装配置）  html5audio标签播放结束怎么触发事件_onended回调方法【教程】  如何在阿里云购买域名并搭建网站？  Laravel中的withCount方法怎么高效统计关联模型数量  郑州企业网站制作公司,郑州招聘网站有哪些？  PythonWeb开发入门教程_Flask快速构建Web应用  Laravel怎么配置不同环境的数据库_Laravel本地测试与生产环境动态切换【方法】  怎么用AI帮你设计一套个性化的手机App图标？  Zeus浏览器网页版官网入口 宙斯浏览器官网在线通道  如何彻底删除建站之星生成的Banner？  如何批量查询域名的建站时间记录？  Laravel怎么使用Markdown渲染文档_Laravel将Markdown内容转HTML页面展示【实战】  Laravel策略(Policy)如何控制权限_Laravel Gates与Policies实现用户授权  JavaScript 输出显示内容(document.write、alert、innerHTML、console.log)  Laravel API路由如何设计_Laravel构建RESTful API的路由最佳实践  电视网站制作tvbox接口,云海电视怎样自定义添加电视源？  Laravel PHP版本要求一览_Laravel各版本环境要求对照  百度输入法全感官ai怎么关 百度输入法全感官皮肤关闭  Laravel辅助函数有哪些_Laravel Helpers常用助手函数大全  Android GridView 滑动条设置一直显示状态(推荐)  Laravel如何获取当前用户信息_Laravel Auth门面获取用户ID  Laravel如何使用Service Provider注册服务_Laravel服务提供者配置与加载  如何构建满足综合性能需求的优质建站方案？  个人摄影网站制作流程,摄影爱好者都去什么网站？  Laravel如何使用Seeder填充数据_Laravel模型工厂Factory批量生成测试数据【方法】  浅述节点的创建及常见功能的实现  Java垃圾回收器的方法和原理总结  原生JS实现图片轮播切换效果  Python自然语言搜索引擎项目教程_倒排索引查询优化案例  Laravel怎么为数据库表字段添加索引以优化查询