Sublime Text 本身不提供 Scala 支持，所有功能均依赖外部工具链和手动配置；90% 的失败源于 GUI 启动时未继承 PATH，导致终端可用的 scalac/scala 在 Sublime 中报 command not found。
Sublime Text 本身不提供 Scala 支持，所有高亮、编译、运行能力都依赖外部工具链和手动配置；90% 的失败不是插件没装对，而是 scalac 和 scala 在终端能跑通，但在 Sublime 里报 command not found——根本原因是 GUI 启动时 PATH 没继承。
怎么确认 Scala 命令真正在系统里可用？
这是整个配置的起点，跳过这步后面全是空转。
- 在终端执行
scalac -version和scala -version，必须有输出（如Scala compiler version 2.13.12） - 执行
which scalac，返回非空路径（如/usr/local/scala/bin/scalac）；若为空，说明PATH没配对 - macOS 用户特别注意：从 Dock 图标或 Spotlight 启动 Sublime 时，不会加载 ~/.zshrc 中的 PATH；必须用终端执行
open -a "Sublime Text"启动 - Windows 用户检查系统环境变量
Path是否包含scala\bin，且修改后要彻底退出 Sublime 进程（右键菜单 → Exit），不能只关窗口
为什么装了 Scala 插件，.scala 文件还是显示 Plain Text？
插件只是提供语法定义，不自动绑定文件扩展名；Sublime 不会“猜”你打开的是 Scala 文件。
- 先确保已通过 Package Control 安装官方
Scala插件（作者 James Bremner），不是名字带 scala 的任意包 - 打开一个
.scala文件，点击右下角语言标识（默认是Plain Text），选择Scala → Scala - 之后同目录下所有
.scala文件会自动识别；如果仍不生效，检查是否误选了Scala (sbt)或Scala (SublimeREPL)等变体 - 如需全局绑定，可手动编辑
Preferences → Settings – Syntax Specific，加入"syntax": "Packages/Scala/Scala.sublime-syntax"
构建系统里 file_regex 写错会导致什么？
它决定你双击错误信息能不能跳转到对应行；写错就只能靠眼睛找，尤其在大数据脚本里满屏报错时非常痛苦。
- Scala 编译错误格式是
MyApp.scala:5: error: not found: value x，正则必须匹配这个结构 - 正确写法：
"file_regex": "^([^:]+):([0-9]+):(?:[0-9]+):"—— 注意第三段是列号，但 Scala 错误里列号后是冒号+空格+内容，所以用(?:[0-9]+):非捕获组跳过 - 别抄网上泛用的
^.*?:([0-9]+):([0-9]+):，它会把文件名吞掉，导致跳转到错误文件 - 验证方式：编译一个带错误的文件，看 Sublime 底部状态栏是否显示
MyApp.scala:5，且双击能跳过去
运行 Spark 脚本时为什么 scala $file 一定失败？
因为 scala 命令只加载单个文件和 scala-library.jar，而 Spark 代码依赖 spark-sql_2.12、spark-core_2.12 等数十个 JAR，还必须初始化 SparkSession。
- 直接运行
scala MyApp.scala必报NoClassDefFoundError: org/apache/spark/sql/SparkSession - 正确做法是用
sbt package打出 fat jar，再用spark-submit提交；Sublime 里不要硬塞进 Build System - 推荐封装 shell 脚本：
run-spark.sh，内容为sbt clean compile && spark-submit --class "$1" target/scala-*/myapp_*.jar ${@:2} - Build System 中调用：
"shell_cmd": "./run-spark.sh MyApp arg1 arg2"，并确保脚本有执行权限：chmod +x run-spark.sh
最易被忽略的一点：Sublime 的 Build System 不支持交互式输入或长时间运行进程。哪怕只是 sbt console，也会卡住 UI；大数据开发中该用终端就用终端，别强求全在 Sublime 里闭环。
