Sublime Text 默认并不支持 Common Lisp 语法高亮，也没有内置 REPL 集成或一键编译功能。这不是设置漏配，而是因为它本身没有把 lisp 列入原生语言支持列表。当你直接打开一个 .lisp 或 .cl 文件时，通常只会被当作纯文本处理。写下 defun、let 这样的代码后，括号不匹配也不容易及时发现，再按 Ctrl+B 还会弹出 “no build system” 错误——这些都是 Common Lisp 初学者在 Sublime Text 中经常遇到的问题。
如何让 .lisp 文件正确高亮并识别为 Common Lisp
Sublime Text 判断文件语言类型的方式很直接，主要依赖文件后缀和手动绑定，而不是根据文件内容或 shebang 自动识别。因此，安装插件只是完成 Common Lisp 配置的第一步，更关键的是让编辑器启用正确的语法作用域。
- 先打开命令面板（
Ctrl+Shift+P），执行Package Control: Install Package，搜索并安装Lisp插件（注意作者是 wbond，不是“CommonLisp”或“SLIME”）。 - 重启 Sublime Text，打开一个
test.lisp文件。点击窗口右下角显示的语言名称，手动切换为Lisp（注意不要误选成 “Clojure” 或 “Scheme”）。 - 如果你希望所有
.lisp和.cl文件以后都能自动识别为 Common Lisp：在菜单栏点击View → Syntax → Open all with current extension as…，然后再次选择Lisp。 - 验证是否配置成功的方法很简单：输入
(defun hello () (format t "hi"))。如果defun和format显示为高亮颜色，点击括号时能看到配对高亮，并且按下Tab后缩进能自动对齐到上层括号位置，就说明 Sublime Text 已经能够正确识别并高亮 Lisp 代码。
为什么 Ctrl+B 运行 .lisp 文件失败？构建系统必须手动指定 sbcl 或 clisp
Sublime Text 中的 Ctrl+B 本质上只是执行一条 shell 命令。它不会自动帮你查找 sbcl 或 clisp 解释器，也不会处理 Common Lisp 的交互式 REPL 工作流。常见报错例如 'sbcl' is not recognized 或 exit code 127，本质上都说明同一个问题：解释器路径不可用，或者系统环境变量没有配置好。
- 第一步，先确认你在终端里可以正常调用 Lisp 解释器。可以执行
sbcl --version或clisp --version，确保命令有正常输出。Windows 用户如果是通过 Scoop 安装，SBCL 的路径通常类似：C:Usersamescoopappssbclcurrentsbcl.exe。 - 接下来，新建一个构建系统。操作路径：
Tools → Build System → New Build System…。把下面的内容粘贴进去（以 SBCL 为例）：
{
"cmd": ["sbcl", "--script", "$file"],
"selector": "source.lisp",
"working_dir": "$file_path",
"file_regex": "^; in: (.+)\n; ([^\n]+):([0-9]+):([0-9]+)"
}
- 将这个文件保存为
Lisp.sublime-build（它会自动放入Packages/User/目录）。 - 一个非常关键的细节是：在运行构建之前，一定要先保存当前文件（
Ctrl+S）。如果文件尚未保存，$file变量会是空字符串，构建过程会立即失败。 - 如果你更习惯使用
clisp，只需要把"cmd"修改为["clisp", "$file"]。不过要注意，clisp不支持--script模式，因此脚本中必须包含可执行入口，比如(ext:exit)。
怎样接入 SLIME + Swank 实现真正的 REPL 交互（非简单脚本运行）
仅依靠构建系统，你只能执行一次性脚本，无法获得完整的 Common Lisp 开发体验。像 eval-defun、inspect、step 这类函数式编程中常用的交互能力，单纯的 Ctrl+B 是做不到的。SLIME 一直是 Common Lisp 开发的事实标准，而在 Sublime Text 中，则需要借助插件与 Swank 服务进行桥接。
- 首先，你需要手动在终端中启动 Swank 服务。命令大致为：
sbcl --load ~/.swank.lisp（前提是你已经通过quicklisp安装了swank）。Swank 启动后通常会监听localhost:4005端口。 - 然后，在 Sublime Text 中安装插件：
Package Control: Install Package，搜索SLIMESublime（作者 jfischoff）。这是一个轻量级的 SLIME 客户端，不依赖 Emacs，也适合在 Sublime 里进行 Common Lisp 开发。 - 在插件设置中填写 Swank 的连接地址：打开
Preferences → Package Settings → SLIMESublime → Settings，在右侧添加：
"swank_host": "127.0.0.1", "swank_port": 4005
- 打开一个
.lisp文件后，按下Ctrl+Alt+R尝试连接 Swank。当状态栏显示SLIME: Connected时，才表示 REPL 交互环境已经准备完成。 - 连接成功后，
Ctrl+Enter可以把当前光标所在表达式发送到 REPL 执行；Ctrl+Shift+Enter可以发送整个 defun；而Ctrl+Alt+E则能弹出一个独立的 REPL 面板，方便实时调试和测试 Common Lisp 代码。 - 还需要特别注意：SLIME 是否正常工作，完全依赖于 Swank 服务是否已启动。如果连接失败，第一步不应该急着检查 Sublime Text 设置，而是先回到终端执行
netstat -an | grep 4005，确认对应端口是否处于LISTEN状态。
容易被忽略的细节：编码、括号匹配与项目级加载
Common Lisp 对编码格式和符号解析非常敏感，而 Sublime Text 的一些默认行为，可能会在不经意间影响脚本执行结果，甚至直接破坏代码语义。
- 所有
.lisp文件都应保存为 UTF-8 无 BOM 格式。如果文件中包含中文内容（例如注释里的; 测试），带 BOM 保存时，SBCL 可能会报出invalid byte sequence错误。 - 括号高亮和自动补全建议显式开启：进入
Preferences → Settings，添加"match_brackets": true和"auto_match_enabled": true。 - 构建系统还有一个常见限制：它不适合直接处理多文件项目。比如你在脚本中写了
(load "utils.lisp")，在--script模式下不会自动设置*default-pathname-defaults*，从而导致加载失败。解决思路是改用自定义命令："cmd": ["sbcl", "--load", "$file"]，并在脚本开头手动加入一句(setf *default-pathname-defaults* (pathname $file_path))。 - 通过 SLIME 成功连接后，可以使用
Ctrl+Alt+L加载当前文件。不过这个操作只在当前 Swank 会话中有效。一旦关闭 Sublime Text 并重新打开，仍然需要再次按下Ctrl+Alt+R重新连接，连接状态不会自动恢复。
