VSCode需配合对应方言解释器才能运行Racket或Scheme代码；Racket推荐vscode-racket扩展，Scheme方言需手动配置tasks.json调用终端解释器，且必须先确保解释器已正确安装并可命令行调用。
VSCode 本身不原生支持 Racket 或 Scheme，必须靠外部解释器 + 扩展协同工作；直接装个“Lisp”扩展就想跑 racket 或 chez 代码，大概率报错 command not found 或卡在 REPL 启动失败。
确认你用的是哪个 Lisp 方言，再选对应解释器
Common Lisp、Racket、Chez Scheme、MIT/GNU Scheme 互不兼容——语法、库、启动方式都不同。VSCode 只是编辑器，真正执行代码的是你本地装的解释器：
-
racket：Racket 官方解释器，支持.rkt文件，自带包管理raco和 REPL -
chez或petite：Chez Scheme 解释器，启动后默认进 REPL，不自动加载文件 -
gsi：Gambit Scheme，需加-e参数才能单行求值，-s才能运行脚本 -
mit-scheme：MIT/GNU Scheme，启动慢，REPL 命令是(load "xxx.scm")，不能直接run
别混淆方言和工具链。比如你写的是 #lang racket 开头的文件，却配了 mit-scheme 路径，VSCode 就算连上 REPL 也只会报 invalid #lang。
用 vscode-racket 扩展跑 Racket 最省事
这是目前对 Racket 支持最稳的扩展（作者 jeff-hykin），它不依赖通用 Lisp 插件，专为 racket 设计：
- 安装后，在命令面板（
Ctrl+Shift+P）搜Racket: Start Repl，它会自动找系统 PATH 里的racket；找不到就提示你填路径 - Windows 下如果
racket.exe没加进 PATH，就手动设"racket.executablePath"为类似C:\Program Files\Racket\racket.exe - 按
Ctrl+Enter可把当前选中表达式发给 REPL；Ctrl+Alt+Enter是整个文件重载 - 它默认用
racket -i启动 REPL，所以能正确处理#lang、模块导入和宏展开
别用 “Common Lisp” 扩展去开 .rkt 文件——它不认识 #lang，括号匹配可能错乱，REPL 输入直接被当成 CL 表达式求值，结果完全不可控。
Scheme 方言得自己搭管道，没有一键方案
VSCode 没有成熟、持续维护的 Chez / MIT / Gambit 专用扩展。可行做法是绕过扩展，用终端 + 自定义 task：
- 在项目根目录建
.vscode/tasks.json，写一个 shell task：
{
"version": "2.0.0",
"tasks": [
{
"label": "Run Scheme",
"type": "shell",
"command": "chez",
"args": ["--script", "${file}"],
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared",
"showReuseMessage": true,
"clear": true
}
}
]
}
-
${file}是当前打开的文件路径，--script让 Chez 直接执行而非进 REPL - MIT Scheme 不支持
--script，得改用mit-scheme --load "${file}" --eval "(exit)"，否则它卡在交互模式不出结果 - Gambit 的
gsi -e只能执行单行，要跑文件得用gsi -script ${file}
这类配置没法自动跳转定义、没变量 hover 提示、不支持断点调试——纯当“带语法高亮的终端编辑器”用。如果你真需要完整 IDE 功能，Scheme 用户普遍回归 Emacs + Geiser 或 DrRacket。
容易被忽略的三个硬性前提
所有配置的前提是解释器已正确安装且可被调用：
- 在终端里直接敲
racket --version或chez --version必须返回版本号，不能报 command not found - Windows 用户注意路径分隔符：VSCode 设置里填
racket.executablePath时，用双反斜杠\或正斜杠/，别用单反斜杠（会被当转义） - macOS/Linux 用户若用
brew install racket，通常racket已在 PATH；但用源码编译的 Chez，得手动把bin/加进~/.zshrc并source，否则 VSCode 终端和插件看到的 PATH 不一致
解释器没跑通之前，任何扩展或 task 配置都是空转。先关掉 VSCode，只在系统终端验证解释器可用性，这步跳不过。
