sublime text 本身不提供 scala 语法提示，必须通过 lsp 插件 + metals 语言服务器 + 正确项目结构（含 build.sbt 的根目录）三者协同实现补全、跳转等语义功能；仅装 scala 语法插件仅支持高亮，无任何智能提示能力。
Sublime Text 本身不提供 Scala 语法提示（如自动补全、跳转定义、类型推导），所谓“语法提示增强”实际是靠外部语言服务器（LSP）+ LSP 插件实现的；直接装个“Scala syntax”插件或官方 Scala 插件，不会带来任何补全能力——它只负责高亮和文件识别。
为什么装了 Scala 插件却没补全、悬停看不了类型？
因为官方 Scala 插件（James Bremner 维护）仅提供 sublime-syntax 文件和基本命令，不含语言服务器逻辑。它不连接 metals，也不启动 bsp 协议进程，所以没有语义级功能。
- 补全、跳转、重命名、错误实时诊断等功能，必须依赖
Metals（由 Scala Center 维护的官方语言服务器） -
Metals需要 Java 运行时（JDK 11+）、sbt或mill项目结构、以及scala.meta编译器支持 - Sublime 端必须安装
LSP插件，并手动配置lsp-metals客户端，不是“装完 Scala 插件就自动有”
如何让 Sublime Text 真正支持 Scala 补全和跳转？
核心路径：装 LSP + 配 metals + 开项目根目录（含 build.sbt）。缺一不可。
- 先通过 Package Control 安装
LSP（作者: sublimelsp），不是LSP-json或LSP-css等子包 - 再安装
lsp-metals插件（Package Control 中搜 “lsp-metals”，作者：tombry） - 确保项目根目录下有
build.sbt（哪怕只有scalaVersion := "2.13.12"），否则metals启动失败，控制台报No build target found - 打开项目根目录（
File → Open Folder），不要只开单个.scala文件——LSP客户端只在文件夹模式下激活 - 首次打开会下载
metalsjar 包（约 80MB），需科学联网；可提前下载metals-launcher并在LSP.sublime-settings中指定"server_binary_path"
常见失败现象和绕不过去的坑
补全不弹、悬停空白、跳转到 definition 失败——90% 是以下某个环节断了：
-
java -version输出是 JRE 而非 JDK：必须用 JDK 11+，且$JAVA_HOME/bin在 PATH 中；Sublime GUI 启动时若没继承 PATH，LSP就找不到 java，日志里会卡在Starting server... - 误把
build.sbt放错位置：它必须在你用Open Folder打开的根目录下，不能嵌套在src/或project/里 - 用了 Scala 3 但
metals版本太旧：lsp-metalsv0.12+ 才支持 Scala 3.3+；检查插件更新状态，别用 Package Control 默认缓存的老版本 - 启用了
SublimeREPL或ScalaSyntax等冲突插件：它们会劫持source.scala作用域，导致LSP不响应；禁用所有非必要 Scala 相关插件，只留LSP和lsp-metals -
metals日志里出现Failed to connect to build server：说明sbt没装或不在 PATH，或build.sbt语法错误；先在终端跑sbt compile确认能过
真正起作用的不是“插件名里带 Scala”，而是 metals 进程是否跑起来、LSP 是否连上、项目结构是否被识别——这三个条件都满足了，补全和跳转才自然出现；否则所有设置都是纸面功夫。
