必须安装 Magic Racket 插件且 raco 在 PATH 中——缺一不可；Common Lisp 等插件因语法、模块、宏、REPL 机制不兼容，连 #lang racket 都会报错。
必须装 Magic Racket 插件，且系统 PATH 中能直接调用 raco——缺一不可。Common Lisp 插件、Scheme 扩展、通用 Lisp 支持类插件全部无效，连 #lang racket 都会报错。
为什么 Common Lisp 插件跑不了 Racket 代码
Racket 和 Common Lisp 是两种完全不同的语言实现，不是“同一家族的不同版本”：
-
require和provide在 Racket 中是模块系统核心，在 CL 里根本不存在对应机制 - Racket 的宏系统（
define-syntax、syntax-parse）语法和展开逻辑与 CL 的defmacro不兼容 - Common Lisp 插件默认调用
sbcl或clisp，而 Racket 必须用racket或raco启动 REPL - REPL 提示符不一致：
>（Racket） vsCL-USER>（CL），插件解析器直接崩溃 - 粘贴含
#lang racket的代码会触发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 必须**双击图标重启**——从旧终端用
code .启动不会读取新PATH
安装 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+ 已内置足够好的缩进逻辑，自定义关键词列表容易出错
Racket: Load file in REPL 和 Racket: Run file in terminal 别混用
这两个命令行为差异明显，选错会导致调试失败或输出污染：
-
Racket: Load file in REPL：把当前文件内容逐行送入专属 REPL 进程，适合调试交互式逻辑、观察变量绑定变化；但不会自动重载已加载模块，改完代码要再点一次 -
Racket: Run file in terminal：等价于终端执行racket your-file.rkt，适用于脚本式程序，输出干净、无>提示符干扰 - 如果遇到
module: no such file，大概率是路径含中文或空格，换纯英文路径重试 - 教学场景中，初学者常卡在括号配对错乱或注释失效——问题其实出在编辑器底层识别逻辑：
editor.guides.bracketPairs对 Racket 的[、{、#(等非标准括号支持很弱，Magic Racket 会接管这部分，但前提是它已成功激活
