必须安装 magic racket 插件且 path 中包含 raco，common lisp 插件因语法、模块系统、repl 和工具链不兼容而无法运行 racket 代码。
必须装 Magic Racket 插件，且系统 PATH 中要有 raco——缺一不可。通用 Lisp 扩展对 Racket 完全无效，连 #lang racket 都会报错。
为什么不能用 Common Lisp 插件跑 Racket
Racket 是 Scheme 的超集，模块系统、宏语法、REPL 行为和错误提示格式都和 Common Lisp 不兼容：
-
require和provide在 Racket 中是模块边界控制，在 CL 里根本不存在对应语义 - Common Lisp 插件默认调用
clisp或sbcl，而 Racket 必须用racket或raco - REPL 提示符不一致：
>（Racket） vsCL-USER>（CL），插件解析器直接崩溃 - 粘贴含
define-syntax或syntax-parse的代码会触发invalid read syntax
验证 raco 是否可用是第一步
VSCode 启动 Magic Racket 前，先确认终端能直接调用 raco：
- 打开系统终端（不是 VSCode 内置终端），执行
raco --version，有输出才说明安装和 PATH 正确 - Windows 用户常见问题：
raco默认不在 PATH，需手动把 Racket 安装目录下的bin（如C:\Program Files\Racket\bin）加进系统环境变量 - macOS/Linux 若用官网 pkg 安装，
~/.racket/bin可能未加入$PATH；Homebrew 安装通常自动配置，但仍建议检查echo $PATH - VSCode 必须重启才能读取新 PATH —— 改完环境变量后双击图标启动，别从旧终端用
code .
安装 Magic Racket 并启用 LSP 支持
Magic Racket 是目前唯一稳定支持 Racket LSP 的插件（跳转定义、悬停文档、错误下划线），但它依赖本地工具链：
- 在 VSCode 扩展市场搜 “Magic Racket” 并安装
- 安装后无需额外配置即可运行文件或启动 REPL，但 LSP 功能（补全、格式化）需手动启用：
raco pkg install racket-langserver - 若遇到缩进混乱，可在
settings.json中关闭 VSCode 默认缩进引导："[racket]": { "editor.guides.indentation": false, "editor.formatOnType": true } - 不要装 AyaSEditor 等第三方缩进插件——Magic Racket 8.10+ 已内置足够好的缩进逻辑，且自定义关键词列表容易出错
运行和调试的两个关键命令别混用
Magic Racket 提供两种执行方式，行为差异明显：
-
Racket: Load file in REPL：把当前文件内容逐行送入专属 REPL 进程，适合调试交互式逻辑、观察变量绑定变化；但不会自动重载已加载模块，改完代码要再点一次 -
Racket: Run file in terminal：等价于终端执行racket your-file.rkt，适用于脚本式程序，输出干净、无>提示符干扰 - 若报
module: no such file，大概率是路径含中文或空格，请换纯英文路径重试 - 调试需手动创建
.vscode/launch.json，最简配置如下：{ "version": "0.2.0", "configurations": [ { "type": "racket", "name": "Debug Racket File", "request": "launch", "program": "${file}" } ] }
最容易被忽略的是：括号配对高亮（editor.guides.bracketPairs）在 Racket 中默认失效，不是插件问题，而是 VSCode 底层识别逻辑未适配 S-expression 深度嵌套结构；目前只能靠 editor.guides.highlightActiveBracket 勉强辅助，没有真正可靠的括号匹配方案。
