sublime text 本身不提供 scala 语法提示，必须通过 lsp 插件桥接 metals 语言服务器实现智能补全、跳转定义等功能；官方 scala 插件仅支持语法高亮和文件关联，不解析 ast 或启动语言服务。
Sublime Text 本身不提供 Scala 语法提示（如自动补全、跳转定义、符号索引），所谓“增强”只能靠外部工具链配合插件实现；真要获得接近 IDE 的体验，必须引入 Metals + BSP，否则所有“提示”都是静态语法高亮的假象。
为什么装了 Scala 插件却没代码补全？
官方 Scala 插件（James Bremner 维护）只做两件事：语法高亮、文件关联。它不连接编译器，不解析 AST，也不启动语言服务器——所以你敲 list. 不会弹出 map 或 filter，右键 Go to Definition 也灰掉。
- 这不是插件缺陷，是设计使然：Sublime Text 原生不支持 LSP（Language Server Protocol）
- 想获得补全/跳转/重命名等能力，必须手动接入
Metals（Scala 官方推荐的语言服务器） - Metals 依赖
sbt或BSP协议通信，不是加个插件就能开箱即用
Metals 怎么在 Sublime Text 里跑起来？
Sublime Text 没有内置 LSP 支持，得靠第三方插件桥接。目前唯一稳定可用的是 LSP 插件（by Sublimelsp），但它需要你手动配置 Metals 启动参数和项目根路径。
- 先通过 Package Control 安装
LSP插件，再安装LSP-metals（注意不是 “Metals for Sublime” 等非官方包） - 确保系统已安装
coursier（cs install metals可生成可执行文件），且metals在PATH中（终端能执行metals --help） - 打开一个含
build.sbt的 Scala 项目目录，LSP会自动检测并启动 Metals；若不触发，按Ctrl+Shift+P→LSP: Attach Language Server→ 选metals - 首次启动会下载 Scala 标准库源码和索引，耗时较长（尤其大数据项目含 Spark/Hadoop 依赖时），别关窗口
file_regex 写错会导致 Metals 提示失效？
不会。Metals 的诊断（diagnostics）、补全、跳转走的是 LSP JSON-RPC 通道，和构建系统的 file_regex 完全无关。file_regex 只影响 Ctrl+B 编译后点击错误行的跳转行为。
- 但如果你混用构建系统和 Metals：比如用
shell_cmd直接调scalac，又同时启 Metals，两者诊断会冲突，导致重复报错或提示延迟 - 正确做法：禁用所有自定义 Scala 构建系统（Tools → Build System → Automatic），让 Metals 全权接管编译与检查
- 验证 Metals 是否就绪：打开
.scala文件，状态栏应显示Metals (ready)；按Ctrl+Shift+P输入LSP: Show Diagnostics应列出编译错误
大数据开发场景下特别容易卡在哪？
Spark、Flink 或 Kafka 项目普遍依赖大量二进制 JAR 和跨版本 Scala 库，Metals 启动时会尝试下载并反编译它们来构建符号索引——这个过程极易失败或卡死。
- 常见现象：状态栏一直显示
Metals (indexing...)，CPU 占用高，数小时无响应 - 解决方法：在项目根目录新建
.metals/config.json，加入"superMethodLenses": false和"semanticdbVersion": "4.8.12"（匹配你项目的 Scala 版本） - 更关键的是限制索引范围：在
build.sbt中显式排除测试依赖，例如Compile / scalacOptions += "-P:semanticdb:sourceroot:" + baseDirectory.value.getAbsolutePath - 别在 Sublime 里直接打开
target/或project/目录——这些临时文件会干扰 Metals 的 workspace 解析
