Sublime Text 本身不运行 Scala，仅调用系统已安装的 scalac 和 scala 命令；必须先在终端验证 scalac -version 和 scala -version 可执行、which scalac/which scala 返回有效路径，并确保 macOS 下通过终端启动 Sublime 以继承 PATH，再配置含正确 file_regex、绝对路径和分设编译/运行的构建系统。
Sublime Text 本身不运行 Scala，它只调用你系统里装好的 scalac 和 scala 命令——如果终端里都跑不通，Sublime 里就一定失败。
验证 scalac 和 scala 能否在终端执行
这是整个配置的起点，90% 的问题卡在这一步。别跳过，直接打开终端敲：
-
scalac -version和scala -version必须有输出（比如Scala compiler version 2.13.12） -
which scalac和which scala必须返回非空路径，例如/usr/local/scala/bin/scalac - 如果没输出或报
command not found，说明PATH没配对：macOS/Linux 编辑~/.zshrc或~/.bash_profile，追加export PATH="/path/to/scala/bin:$PATH"；Windows 则检查系统环境变量Path是否含scala\bin - macOS 用户特别注意：用 Dock 图标启动 Sublime 时，它不会继承 shell 的
PATH。必须用终端执行open -a "Sublime Text"启动，或在 Sublime 控制台（Ctrl+`）中运行import os; print(os.environ.get('PATH'))确认路径存在
写一个真正能跳转错误行的 Scala.sublime-build
网上抄来的模板大概率失效，因为 scalac 把错误写在 stderr，而默认构建系统只捕获 stdout，结果编译出错却点不了行号。
- 保存为
~/Library/Application Support/Sublime Text/Packages/User/Scala.sublime-build（macOS）或对应 Windows/Linux 路径 -
cmd字段必须用绝对路径，例如["/usr/local/scala/bin/scalac", "$file"]；用shell_cmd更灵活，但得加2>&1合并错误流："shell_cmd": "/usr/local/scala/bin/scalac \"$file\" 2>&1" -
working_dir设为"$file_path"，否则import语句因相对路径找不到依赖 -
file_regex必须匹配 Scala 错误格式，例如"^([^:]+):([0-9]+):([0-9]+):"，才能点击跳转到MyApp.scala:5: error: - 不要把编译和运行塞进一个构建系统——推荐分设两个：
Scala（只编译）和Scala Run（运行），避免类路径混乱
Scala Run 构建系统为什么总报 “no main class found”
这不是 Sublime 的问题，而是 scala 命令的行为限制：它只能运行已编译的 .class 文件，且类名必须与文件名严格一致、含 def main 方法。
- 确保先用
Scala构建系统编译成功，生成了$file_base_name.class（比如Hello.scala→Hello.class） -
Scala Run的cmd应为["/usr/local/scala/bin/scala", "$file_base_name"]，不是"$file"；且working_dir仍需是"$file_path" - 如果代码用了
package，scala Hello就会失败——此时必须用scala -cp . Hello或改用sbt run，Sublime 原生不处理包路径 - JDK 版本要匹配：Scala 2.13 推荐 JDK 8–17，Scala 3 要求 JDK 11+；
java -version输出不能是 JRE
语法高亮和项目级支持的真实边界
装个插件就能高亮，但别指望 Sublime 像 VS Code + Metals 那样提供类型推导、跳转定义或依赖管理。
- 通过 Package Control 安装官方维护的
Scala插件（作者 James Bremner），不是名字带 “scala” 的任意插件 - 打开的是整个项目根目录（含
build.sbt），不是单个.scala文件，否则插件无法识别结构 - 状态栏右下角必须显示
Scala，否则手动点击切换：View → Syntax → Scala - SBT 构建、多模块、依赖解析这些事，Sublime 不参与——你得在终端里跑
sbt compile，编辑器只负责写代码和看报错
最常被忽略的点：Sublime 启动方式决定它能不能看到你的 PATH，而 file_regex 写错一个字符，错误就点不了跳转。这两处不调通，其他所有配置都是白忙。
