Sublime Text需手动配置语法绑定、PATH路径和构建系统才能支持Racket教学环境：先安装官方Racket语法包并绑定.rkt后缀，再显式配置racket路径至构建系统，最后用精准file_regex实现错误点击跳转。
Sublime Text 本身不提供 Racket 教学环境，所谓“能写、能跑、点错跳转”这三件事，全靠你手动配对 source.racket scope、racket 可执行路径和 file_regex 三者——缺一个，.rkt 文件就卡在“Plain Text”或 command not found: racket。
为什么 .rkt 文件打开还是 Plain Text？
这不是插件没装，是 Sublime 没把文件识别为 Racket 代码。右下角显示 “Plain Text”，说明 source.racket 这个语法作用域根本没加载成功。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Set Syntax: Racket并回车；如果列表里没有，说明没装官方Racket语法包（别装R-Box或Scheme Complete，它们会劫持后缀） - 装完后打开一个
test.rkt，确认右下角显示 “Racket” ——只有这时selector才匹配source.racket - 要永久绑定后缀：菜单
View → Syntax → Open all with current extension as…，选 “Racket”，然后编辑该语法配置，在{"extensions": ["rkt"]}里补上"scm"和"ss"
Ctrl+B 报错 command not found: racket 怎么办？
Sublime 不读你的 shell 配置（如 .zshrc），也不继承 GUI 环境变量。终端里 racket -v 能输出 ≠ Sublime 能调用。
- 先在系统终端（不是 Sublime 内置终端）执行
racket -v，有输出才继续；Windows 用户安装时务必勾选 “Add to PATH” - macOS/Linux：用
which racket查路径（如/usr/local/bin/racket），在构建系统中通过"path"字段显式注入："path": "/usr/local/bin:$PATH" - Windows：避免空格路径陷阱，直接写绝对路径：
"cmd": ["C:\Program Files\Racket\racket.exe", "$file"] - 别依赖
"shell": true：它在 Windows 上易导致窗口一闪而过，在 macOS 上可能干扰 UTF-8 输出；真要 shell，改用"cmd": ["sh", "-c", "racket "$file""]
构建系统怎么写才能支持教学常用场景？
教学场景的核心需求就两个：单文件快速运行（比如学生交一个 hello.rkt），以及错误信息能点击跳转到具体行——这完全取决于 file_regex 是否匹配 Racket 默认报错格式。
- 保存为
Racket.sublime-build（必须以这个后缀结尾），内容示例：
{
"cmd": ["racket", "$file"],
"file_regex": "^(.*?):([0-9]+):([0-9]+): (.*)$",
"selector": "source.racket",
"working_dir": "$file_path"
}
"selector": "source.racket" 必须和你当前文件的语法 scope 一致；若右下角显示 “Scheme”，就得改成 source.scheme
"file_regex" 必须严格匹配 Racket 错误输出格式，例如 hello.rkt:5:12: undefined identifier: x；不匹配就点不了跳转"working_dir": "$file_path"，否则 require 相对路径会失败容易被忽略的兼容性细节
跨平台构建系统最常栽在三个地方：Windows 的反斜杠转义、macOS 的 shell 编码、以及 Linux 下 racket 命令权限未设为可执行。更隐蔽的是，Racket v8.13+ 默认启用 read-language 安全限制，如果学生代码里用了 #lang at-exp 或自定义语言，file_regex 可能捕获不到行号——这时得加 -l racket/base 强制基础环境，或改用 "cmd": ["racket", "-i", "$file"] 启动交互式模式看原始输出。
