Sublime Text 本身不支持 Scala 项目构建与依赖管理，真正编译、测试和打包由 sbt 驱动；Sublime 仅作为轻量编辑器配合外部流程，需安装 Scala 插件启用语法高亮和基础跳转，跨文件符号解析应交由 sbt 编译输出或改用 VS Code + Metals。
Sublime Text 本身不支持 Scala 项目构建与依赖管理，sbt 才是真正驱动编译、测试和打包的核心；Sublime 只能作为轻量编辑器配合外部构建流程，强行在 Sublime 内集成 sbt 构建（比如用 SublimeBuild）容易因环境变量缺失、JVM 配置不一致或 classpath 错乱导致 ClassNotFoundException 或 NoClassDefFoundError。
让 Sublime 正确识别 Scala 语法和符号跳转
默认安装的 Sublime 不认识 .scala 文件，需手动启用语法高亮和基础导航：
- 通过
Package Control安装Scala插件（作者：sublimescala），它提供关键字着色、括号匹配和简单Ctrl+Click跳转到定义（仅限当前文件内） - 避免安装过重的插件如
Ensime或Metals的 Sublime 适配版——它们依赖语言服务器，但 Sublime 对 LSP 支持不稳定，常卡在Connecting to server... - 若需跨文件跳转或类型提示，不如直接用
Metals+ VS Code；在 Sublime 中应接受“只看不查”的定位，把符号解析交给sbt compile后的.class或.jar输出
从命令行调用 sbt 编译 Scala 脚本时的关键参数
sbt 默认按标准项目结构组织代码，而分布式数据处理脚本（如 Spark 作业）往往以单文件形式快速验证逻辑，这时需绕过 src/main/scala 约束：
- 用
sbt console加载脚本：启动 REPL 后执行:load MyJob.scala，适合调试小段逻辑，但无法使用@main或访问spark-sql_2.12等依赖，除非提前在build.sbt中声明 - 更可靠的方式是写一个最小
build.sbt，包含scalaVersion := "2.12.18"和libraryDependencies += "org.apache.spark" %% "spark-sql" % "3.4.2"，再把脚本放src/main/scala/MyJob.scala，然后运行sbt compile—— 注意 Spark 依赖必须与集群 Scala 版本严格匹配，否则运行时报java.lang.NoSuchMethodError: scala.Product.$init$ - 若坚持单文件提交（如
spark-submit --class Main MyJob.scala），需确保该文件含object Main extends App，且sbt已通过addSbtPlugin("com.eed3si9n" % "sbt-assembly" % "2.2.0")打成 fat jar，否则spark-submit找不到scala-library.jar
Sublime 中触发 sbt 构建失败的典型现象与修复
常见错误不是语法报错，而是构建流程断在环境层面：
-
java.lang.OutOfMemoryError: Metaspace：Sublime 的exec构建系统默认 JVM 参数太小，在Tools > Build System > New Build System中改写为：{ "shell_cmd": "sbt -J-Xmx2g -J-XX:MaxMetaspaceSize=512m compile", "file_regex": "^(.*?):([0-9]+):([0-9]+):" } -
error: not found: value spark：说明sbt没加载依赖，检查build.sbt是否漏了name := "my-spark-job"——sbt要求项目名非空才能正确解析libraryDependencies - 修改
.scala后 Sublime 构建仍用旧 class，是因为sbt compile默认不清理输出目录；加clean到构建命令：sbt clean compile，或在build.sbt中加cleanFiles += baseDirectory.value / "target"
真正棘手的从来不是写几行 spark.read.parquet(...)，而是 sbt 加载的 scala-library 版本和集群中 Spark 自带的是否一致，以及 Sublime 构建时用的 PATH 是否指向你预期的 JDK —— 这些细节不会报错，但会让 job 在 executor 上静默失败。建议每次 sbt compile 后，用 javap -cp target/scala-2.12/myjob_2.12-0.1.jar MyJob 确认主类签名无误。
