需配置Calva扩展、Leiningen或Clojure CLI工具链、REPL连接、括号着色与智能缩进、快捷求值功能:安装Calva;选装Leiningen或Clojure CLI并初始化项目;通过Calva命令启动并连接REPL;启用括号配对着色、自动缩进及保存时格式化;使用Cmd+Enter等快捷键实现表达式级求值与文件加载。

如果您希望在 Visual Studio Code 中高效编写 Clojure 代码,需配置专用扩展与运行环境以支持语法高亮、REPL 集成、括号匹配及代码导航等功能。以下是实现 Clojure 开发体验的关键配置步骤:
本文运行环境:MacBook Air M2,macOS Sequoia。
一、安装 Calva 扩展
Calva 是专为 Clojure 和 ClojureScript 设计的 VSCode 扩展,提供完整的 REPL 集成、代码求值、格式化、跳转定义等核心功能,无需额外配置即可启用基础开发能力。
1、启动 VSCode,点击左侧活动栏的扩展图标(或按 Cmd+Shift+X)。
2、在搜索框中输入 Calva,找到由 Better Than Tomorrow 发布的官方扩展。
3、点击“安装”按钮,安装完成后重启 VSCode 或直接启用该扩展。
二、配置 Leiningen 或 Clojure CLI 工具链
Calva 依赖本地 Clojure 构建工具启动 REPL,Leiningen 与 Clojure CLI(clojure-tools)是两种主流选择,二者互不冲突,可任选其一完成初始化。
1、打开终端,执行 brew install leiningen 安装 Leiningen(macOS 用户)。
2、或执行 brew install clojure-lsp 并确保 clojure 命令已通过 brew install clojure 可用。
3、新建一个空目录,在终端中运行 lein new app my-clojure-app 或 clojure -Tnew app :name my-clojure-app 初始化项目。
三、连接项目 REPL
Calva 自动识别项目根目录下的 project.clj(Leiningen)或 deps.edn(Clojure CLI),并据此启动对应类型的 REPL,实现代码实时求值与状态交互。
1、在 VSCode 中使用 Cmd+P 打开命令面板,输入 Calva: Start a Project REPL and Connect。
2、选择当前工作区路径,Calva 将自动检测构建工具类型并启动 REPL 进程。
3、底部状态栏出现 Calva REPL 标识,且输出窗口显示 user=> 提示符,表示连接成功。
四、启用括号着色与智能缩进
Clojure 重度依赖括号结构,VSCode 默认括号高亮较弱,需通过设置增强视觉反馈与编辑精度,避免配对错误与缩进混乱。
1、进入 VSCode 设置(Cmd+,),搜索 bracket pair colorization,确保已启用。
2、搜索 editor.autoIndent,设为 full;再搜索 clojure.formatOnSave,设为 true。
3、在 settings.json 中手动添加:"editor.guides.bracketPairs": true 以开启嵌套括号引导线。
五、快捷求值与调试操作
Calva 提供基于光标位置的上下文感知求值能力,支持从单表达式到整个文件的粒度控制,大幅减少手动复制粘贴至 REPL 的操作成本。
1、将光标置于任意 Clojure 表达式内(如 (println "hello")),按下 Cmd+Enter 即在当前 REPL 中求值并显示结果。
2、选中一段代码后按 Cmd+Alt+C 可仅发送选中内容至 REPL,不执行。
3、在 .clj 文件中右键,选择 Calva: Load Current File in REPL 可加载全部定义。











