Sublime启动时未继承PATH导致sbt/scala不可用，根本原因是GUI启动不读shell配置；macOS须用open -a或subl命令启动，Linux用subl命令，Windows需确认Path含sbt\bin，并在控制台验证os.environ.get('PATH')是否包含对应路径。
Sublime 启动时根本没继承 PATH，sbt 就不可能找到
macOS 下点 Dock 图标打开 Sublime，os.environ.get('PATH') 里大概率没有 sbt 或 scala 路径。这不是插件问题，是启动方式决定的——GUI 应用不读 shell 配置文件。
验证方法：按 Ctrl+` 打开 Sublime 控制台，输入：import os; print(os.environ.get('PATH'))
如果输出里没出现 /usr/local/bin、/opt/homebrew/bin 或你装 sbt 的路径，说明环境变量没进来。
- macOS 必须用终端启动：
open -a "Sublime Text"或subl .（确保subl命令已软链到正确位置） - Linux 用户检查是否用
subl命令而非桌面图标；Windows 用户确认系统Path环境变量含sbt\bin - 别依赖
shell_cmd自动找sbt——它照样找不到，除非 PATH 已生效
sbt 构建系统里 working_dir 错了，build.sbt 就读不到
Sublime 的构建系统若设 working_dir 为 $file_path，而你只打开了单个 .scala 文件，sbt compile 会报 Not a valid key: compile——因为它压根没找到项目根目录下的 build.sbt。
真正起作用的是 $project_path，但前提是：你得用 subl .（不是 subl build.sbt）打开整个项目文件夹，且该文件夹下有 build.sbt。
- 构建系统中必须写：
"working_dir": "$project_path" - 如果项目用了多模块（比如
core/、spark-job/），别在根目录直接跑sbt run，先确认当前 Sublime 窗口的 project path 是模块子目录还是根目录 -
file_regex要匹配 sbt 实际错误格式："^([^:]+):([0-9]+):([0-9]+):.*$"，否则双击src/main/scala/Job.scala:42:16:跳不了行
Scala 3 + Spark 作业在 Sublime 里没法用 Build System 直接运行
sbt run 在终端里能交互、能 Ctrl+C 中断，但塞进 Sublime 的构建系统后，进程一结束就关闭管道，根本没法输参数、看日志流、或中途停止——尤其 Spark local[*] 模式启动后卡住，UI 就假死。
更麻烦的是，sbt package 打出的 jar 往往要配合 spark-submit 运行，而 spark-submit 本身需要传一堆 --conf、--jars 参数，Build System 不支持动态参数输入。
- 别写
"cmd": ["sbt", "run"]这种构建系统——它只适合 Hello World 级单文件 - 真实场景下，把编译和打包分离：
sbt compile和sbt package各自配一个构建系统，输出 jar 后手动在终端跑spark-submit - 如果非要在编辑器里触发，用 Sublime 的
Terminal插件（如 Terminus），绑定快捷键执行预设命令，而不是 Build System
插件选错或没激活，语法高亮和跳转就全失效
状态栏右下角显示 Plain Text 或 Scala (sbt)，而不是干净的 Scala，基本等于没配置成功。很多用户装了名字带 “scala” 的插件，结果发现不支持 Scala 3 的新语法（比如 given、export），或者无法跳转到 def 定义。
官方唯一推荐的是 James Bremner 维护的 Scala 插件（Package Control 里搜 “Scala”，第一个，作者字段明确写着 James Bremner），不是 sublack 也不是 ScalaSyntax。
- 安装后必须彻底退出 Sublime 再重开——插件不会热加载语法定义
- 打开项目根目录后，右下角语言名点击 → 选二级菜单里的
Scala（注意不是Scala (sbt)或Scala (SublimeREPL)） - 如果仍不亮，检查文件编码是否为 UTF-8：
File → Save with Encoding → UTF-8，中文注释乱码常因编码不一致导致
