VSCode 运行 Racket 必须安装 Magic Racket 插件且 raco 在 PATH 中，通用 Lisp 扩展因语法、模块、宏、REPL 等机制差异完全不兼容。
VSCode 能直接运行 Racket 代码，但必须装 Magic Racket 插件并确保 raco 在系统 PATH 中——缺一不可。其他“Lisp 支持”类扩展（比如通用 Common Lisp 扩展）对 Racket 基本无效。
为什么不能用通用 Lisp 扩展跑 Racket
Racket 是 Scheme 的超集，语法、模块系统、宏机制和 REPL 行为都和 Common Lisp 完全不同。用 clisp 或 sbcl 配置的插件无法识别 #lang racket、define-syntax、require 等核心结构，运行会报 undefined function 或 invalid read syntax 错误。
- Common Lisp 扩展默认找
clisp.exe或sbcl，而 Racket 需要调用racket或raco -
require和provide在 Racket 中是模块边界控制，在 CL 里根本不存在对应语义 - REPL 响应格式也不同：Racket 的
>提示符不兼容 CL 的CL-USER>
安装 Magic Racket 并验证 raco 可用性
Magic Racket 是目前唯一稳定支持 Racket LSP（跳转定义、悬停文档、错误下划线）的 VSCode 插件。但它依赖本地 raco 工具链，不是装完插件就完事。
- 先确认
raco在终端可用：打开终端执行raco --version，有输出才说明 Racket 已正确安装且 PATH 设置成功 - Windows 用户常见坑：
raco默认不在 PATH，需手动把 Racket 安装目录下的bin（如C:\Program Files\Racket\bin）加进系统环境变量 - macOS/Linux 用户若用
brew install racket，通常自动配置 PATH；若用官网 pkg 安装，仍需检查~/.racket/bin是否在$PATH中 - 插件安装后无需额外配置即可启用基础功能；如需 LSP（智能补全、格式化），再运行
raco pkg install racket-langserver
运行单个 Racket 文件的两种可靠方式
Magic Racket 提供两个命令，行为差异明显，别混用：
-
Racket: Load file in REPL：把当前文件内容逐行送入一个专属 REPL 进程，适合调试交互式逻辑、观察变量绑定变化 -
Racket: Run file in terminal：等价于终端执行racket your-file.rkt，适用于脚本式程序，输出干净、无 REPL 提示符干扰 - 注意：前者不会自动重载已加载的模块，改完代码需手动再执行一次；后者每次都是全新进程，适合验证最终行为
- 如果遇到
module: no such file，大概率是路径含中文或空格，换纯英文路径重试
容易被忽略的关键点
很多人卡在括号配对错乱或注释失效上，其实问题出在编辑器底层识别逻辑：
- VSCode 默认的括号着色（
editor.guides.bracketPairs）对 Racket 的[、{、#(等非标准括号支持很弱，Magic Racket 会接管这部分，但前提是禁用所有其它括号高亮插件 -
#lang必须写在文件第一行，且前面不能有任何空白或 BOM 字符，否则 Magic Racket 无法识别语言模式，语法高亮和 LSP 全部失效 - 不要手动修改
settings.json里的files.associations把.rkt映射到lisp或clojure，这会让 Magic Racket 失效
