sublime text 配置 scala 需先确保 package control 正常并使用 sublime text 4（build 4143+），再安装 scalasyntax 和 sublimerepl；运行报错需手动配置构建系统 path；项目开发推荐用 sublimerepl 或终端执行 sbt；中文乱码需统一 utf-8 编码、终端 locale 和字体设置。
安装 Scala 语言支持插件失败？先确认 Sublime Text 版本和 Package Control 状态
Sublime Text 本身不原生支持 Scala，必须依赖插件。但很多用户卡在第一步：插件装不上或装了没反应。核心原因通常是 Package Control 未正确安装，或用了不兼容的 Sublime Text 版本（如 Sublime Text 4 的某些旧插件已停更）。
实操建议：
- 确认 Sublime Text 是 v4（推荐 Build 4143+），v3 已停止维护，部分 Scala 插件（如
ScalaSyntax）在 v4 下需手动适配 - 用
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）调出命令面板，输入Install Package Control并执行；若已有，再输Package Control: Install Package - 搜索并安装
ScalaSyntax（语法高亮）和SublimeREPL（运行支持），Ensime已基本废弃，不建议再配置
运行 Scala 代码报错 “command not found: scala”？PATH 和构建系统是关键
即使插件装好了，点击 Ctrl+B 运行时提示找不到 scala 命令，本质是 Sublime 没读到系统 PATH 中的 Scala 可执行路径——尤其 macOS 和 Linux 用户常因 shell 配置（如 ~/.zshrc）未被 GUI 应用继承而失败。
实操建议：
- 终端中运行
which scala，记下输出路径（例如/usr/local/bin/scala或/opt/homebrew/bin/scala） - 在 Sublime 中新建构建系统：
Tools → Build System → New Build System，填入：
{
"shell_cmd": "scala \"$file\"",
"path": "/usr/local/bin:/opt/homebrew/bin",
"file_regex": "^(...*?):([0-9]*):?([0-9]*)",
"selector": "source.scala"
}
path 字段必须显式包含你的 Scala 安装目录，不能依赖 shell 的 $PATH。
想用 sbt 编译/运行项目？别硬套单文件构建，改用终端集成
Sublime 的构建系统适合单文件快速验证，但真实 Scala 项目依赖 sbt，涉及多模块、依赖解析、测试等。强行把 sbt run 塞进构建系统会卡死、无交互、无法中断。
实操建议：
- 放弃用
Ctrl+B运行整个项目，改用SublimeREPL：安装后按Ctrl+Shift+P→SublimeREPL: Scala，它会启动一个嵌入式 REPL，可直接粘贴表达式求值 - 复杂操作（如
sbt test、sbt compile）统一走系统终端：Ctrl+Shift+T（默认快捷键，需确认是否启用Terminal插件）打开当前项目根目录的终端 - 如果常用
sbt，建议在项目根目录放一个.env文件声明SBT_OPTS，避免 Sublime 启动的终端漏掉 JVM 参数
中文乱码、Unicode 字符显示异常？编码和字体设置要同步改
Scala 源码含中文字符串或注释时，Sublime 默认用 UTF-8 打开，但终端输出（尤其是 Windows 的 cmd）可能用 GBK，导致 println("你好") 显示为问号或方块。
实操建议：
- 源文件保存时确认右下角状态栏显示
UTF-8；若不是，点它 →Save with Encoding → UTF-8 - 终端输出问题优先换 shell：Windows 用户改用
Windows Terminal + PowerShell，macOS/Linux 用户确保终端locale输出含UTF-8（如en_US.UTF-8） - Sublime 自身显示异常？检查字体设置：
Preferences → Settings中添加"font_face": "Monaco", "font_options": ["gray_antialias"]（macOS）或"font_face": "Consolas"（Windows），避免某些字体对 Unicode 支持不全
真正麻烦的不是配置步骤，而是 Sublime 对 JVM 进程生命周期缺乏控制能力——比如你没法在构建中优雅 kill 掉一个卡住的 scala -i 进程。这点上 VS Code + Metals 插件或 IntelliJ 仍是更稳的选择。
