.rkt文件打开显示“plain text”是因为sublime未将.rkt后缀映射到source.racket语法scope；需安装官方racket syntax包、手动设置语法、永久绑定扩展名，并确保构建系统中selector、path和file_regex三者精准匹配。
为什么 .rkt 文件一打开就是 Plain Text？
不是插件没装，是 Sublime 根本没把 .rkt 后缀映射到 source.racket 这个语法 scope。右下角显示 “Plain Text”，后续所有高亮、括号匹配、构建触发都失效。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Set Syntax: Racket并回车；如果列表里没有，说明没装官方Racket Syntax包（别装R-Box，它专为 R 语言设计，会劫持.rkt文件） - 装完后打开任意
test.rkt，确认右下角显示 “Racket” ——只有这时selector才真正匹配source.racket - 菜单 →
View → Syntax → Open all with current extension as…，选 “Racket”；再编辑该语法配置（路径通常在Preferences → Package Settings → Racket Syntax → Settings – User），确保"extensions": ["rkt", "scm", "ss"]
Ctrl+B 报错 command not found: racket 怎么办？
Sublime 不继承你终端里的 PATH，即使 racket -v 在终端能跑，它也找不到可执行文件。必须显式告诉构建系统 racket 在哪。
- 先验证：在**系统终端**（不是 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""]
构建系统怎么写才能支持元编程调试和错误跳转？
Racket 元编程（比如 define-syntax、syntax-parse）报错格式和普通代码一致，但若 file_regex 不匹配，错误就只能看不能点——这是教学和调试中最卡人的环节。
-
"selector": "source.racket"必须严格匹配右下角显示的语法名；如果显示 “Scheme”，就得改成source.scheme -
"file_regex": "^(.*?):([0-9]+):([0-9]+): (.*)$"是 Racket 默认错误行格式（如test.rkt:12:5: undefined identifier），漏掉它，错误就无法点击跳转到对应行 - 加
"working_dir": "$file_path"确保宏展开时相对路径正确，尤其涉及include或require多文件场景 - 示例最小可用构建系统（保存为
Racket.sublime-build）：{ "cmd": ["racket", "$file"], "selector": "source.racket", "file_regex": "^(.*?):([0-9]+):([0-9]+): (.*)$", "working_dir": "$file_path", "path": "/usr/local/bin:$PATH" }
为什么宏展开结果不显示或 REPL 不响应？
Sublime 本身不提供 REPL，所谓“元编程开发环境”依赖外部工具链协同；常见卡点不在编辑器，而在 Racket 的启动参数和交互协议。
- 默认构建只执行一次，不支持交互式宏探索；如需类似 DrRacket 的宏步进，得配合
racket -i或plt-racket插件，但 Sublime 内置终端对 ANSI 控制序列支持有限，容易乱码 - 若用
subl --command调用外部 REPL，确保 Racket 已启用 TCP 端口监听（racket -l racket/base -e '(require net/tcp) (define l (tcp-listen 6000))'），否则连接超时 - 元编程常用
#lang racket/base开头，确保语法包已加载；若高亮异常，用Ctrl+Shift+P → Inspect Scope看光标处是否为source.racket，而非source.racket.base（某些旧语法包未覆盖子语言）
真正难的不是配通，而是让宏错误信息能准确定位到 syntax-parse 模式中的某一行——这要求 file_regex 和 Racket 实际输出完全对齐，差一个冒号或空格都会失效。
