Calva 不适合 Scheme,应按方言选工具链:Scheme 用 Chez Scheme + Code Runner(配 .scm 执行映射),Common Lisp 用 CLISP + “Common Lisp”扩展(需手动设路径及编码),Clojure 用 Calva + clojure-tools(macOS/Linux 更稳)。

Calva 不适合 Scheme,vscode-scheme 也不维护了——想在 VSCode 里跑 Scheme 或 Common Lisp,得按方言选工具链,不能混用。
Scheme 开发:用 Chez Scheme + Code Runner(Windows/macOS)
VSCode 本身不带 Scheme 运行能力,必须靠外部解释器 + 插件桥接。Chez Scheme 是当前性能最好、线程支持最稳的开源实现,Code Runner 是唯一能绕过 LSP 直接调用它的轻量方案。
- Windows 下安装 Chez Scheme 后,必须把
ta6nt(64 位 threaded)或i3nt(32 位)所在目录加进系统Path,否则scheme命令不可用 - macOS 用
brew install chezscheme,验证运行scheme --version -
Code Runner配置关键项:"code-runner.executorMapByFileExtension": {".scm": "scheme $fileName"}——注意不是.ss或.rkt,默认 Chez 识别.scm - 别装
vscode-scheme:它只提供语法高亮,不连 REPL,且自 2021 年起未更新,Ctrl+Alt+N运行会静默失败
Common Lisp 开发:CLISP + “Common Lisp” 扩展(跨平台)
CLISP 是 ANSI 兼容性最好、中文路径/编码最稳的 Common Lisp 实现,配合 yzhang 维护的 Common Lisp 扩展,能开箱即用 REPL 和单表达式求值。
- Linux/macOS 安装后,
clisp -q应能直接进入 REPL;Windows 要手动把clisp.exe路径填进扩展设置里的lisp.clispPath,填clisp会报spawn clisp ENOENT - 扩展不自动识别
.lisp文件关联,首次打开需右键 →Change Language Mode→ 选Common Lisp - REPL 启动后,
Ctrl+Enter发送当前 S-表达式,Ctrl+Shift+Enter发送整个文件——但若光标在注释行内,会发送空白行导致 REPL 卡住 - 避免用
quicklisp初始化脚本自动加载:VSCode 扩展的 REPL 启动流程不执行~/.clisprc,需在deps.edn类似位置手动(ql:quickload "...")
Clojure 开发:Calva + clojure-tools CLI(仅 macOS/Linux 推荐)
Calva 是目前 Clojure 在 VSCode 中唯一成熟的方案,但它依赖官方 clojure CLI 工具链,Windows 上 clojure-tools 的 PowerShell 支持不稳定,常卡在 jack-in 步骤。
- macOS 必须用
brew install clojure/tools/clojure,用curl装的 shell 脚本版会因权限问题无法启动嵌入式 nREPL -
deps.edn文件必须存在且至少含{:deps {org.clojure/clojure {:mvn/version "1.12.0"}}},空文件或只有注释会导致Cmd+Alt+C J报No project root found - 启动 REPL 后,
Cmd+Alt+B是“评估当前表”,不是“运行文件”——误以为它等价于python xxx.py会导致反复重载 namespace 失败 - 结构化编辑(如
Ctrl+Shift+P→Calva: Paredit Forward)对新手友好,但默认快捷键与 macOS 系统级输入法切换冲突,建议改用Cmd+Option+→替代
调试与编码细节容易被忽略的点
所有 Lisp 方言在 VSCode 中都不支持断点式调试(launch.json 无对应 type),所谓“调试”本质是交互式求值 + print 辅助。真正容易出问题的是字符编码和路径分隔符。
- Windows 下 CLISP 默认用 GBK,而 VSCode 编辑器默认 UTF-8,保存含中文的
.lisp文件后,REPL 读入会报Invalid byte sequence—— 解决方法是在 CLISP 启动参数加-L utf-8,并在扩展设置中填完整命令:"clisp -L utf-8 -q" - Scheme 的
load函数认相对路径,但 VSCode 当前工作目录默认是打开的文件夹根,不是.scm文件所在目录,(load "utils.scm")失败时先(cd "/full/path/to/dir") - Clojure 的
deps.edn不支持 Windows 反斜杠路径,:local/root "src\clj"会解析失败,必须写成:local/root "src/clj"



















