要在 VSCode 中高效编写 Clojure 代码，需依次安装 Calva 扩展、配置 Clojure CLI 工具、初始化项目并连接 REPL、启用智能提示与导航、配置格式化与保存行为。
如果您希望在 Visual Studio Code 中高效编写 Clojure 代码，但尚未配置合适的扩展与环境，则可能是由于缺少对 Lisp 方言特性的深度支持。以下是为 VSCode 搭建 Clojure 开发环境的具体操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Calva 扩展
Calva 是专为 Clojure 和 ClojureScript 设计的 VSCode 扩展，提供 REPL 集成、代码格式化、求值支持及符号跳转等核心功能，是当前最主流的 Clojure 开发工具链组件。
1、打开 VSCode，点击左侧活动栏的扩展图标（或使用快捷键 Ctrl+Shift+X）。
2、在搜索框中输入 Calva，找到作者为 BetterThanTomorrow 的扩展。
3、点击“安装”按钮，等待扩展下载并启用。
4、重启 VSCode 以确保 Calva 完全加载。
二、配置 Clojure CLI 工具
Clojure CLI（clojure-tools）是官方推荐的构建与依赖管理工具，Calva 依赖其启动 REPL 会话，必须确保系统中已正确安装并可被 VSCode 访问。
1、在终端中执行 brew install clojure/tools/clojure（macOS）或通过官方脚本安装 CLI 工具。
2、验证安装：运行 clojure --version，确认输出包含版本号（如 1.11.x）。
3、确保 clojure 命令可在 VSCode 内置终端中直接调用，必要时在 VSCode 设置中配置 calva.replConnectSequences 路径。
三、初始化项目并连接 REPL
Calva 通过识别项目根目录下的 deps.edn 文件自动配置开发会话，需确保项目结构符合 Clojure CLI 规范。
1、在终端中执行 clojure -Tnew app :template io.github.seancorfield/depstar :name my-project 创建新项目。
Lucene是apache软件基金会4 jakarta项目组的一个子项目，是一个开放源代码的全文检索引擎工具包，但它不是一个完整的全文检索引擎，而是一个全文检索引擎的架构，提供了完整的查询引擎和索引引擎，部分文本分析引擎（英文与德文两种西方语言）。 Lucene的目的是为软件开发人员提供一个简单易用的工具包，以方便的在目标系统中实现全文检索的功能，或者是以此为基础建立起完整的全文检索引擎。Lucene提供了一个简单却强大的应用程式接口，能够做全文索引和搜寻。在Java开发环境里Lucene是一个成熟的免
2、在 VSCode 中使用“文件 → 打开文件夹”加载该项目根目录。
3、按下 Ctrl+Alt+C Ctrl+Alt+J 启动 Jack-in 流程，Calva 将自动检测 deps.edn 并启动 REPL。
4、观察底部状态栏出现 Connected to nREPL 提示，表示 REPL 已就绪。
四、启用代码智能提示与导航
Calva 利用 nREPL 协议获取运行时元数据，从而实现函数跳转、参数提示和文档内联显示，该能力依赖于 REPL 处于活跃连接状态。
1、将光标置于任意函数名上，按下 Ctrl+Click 或右键选择“转到定义”，跳转至源码或 Clojure 核心命名空间。
2、在括号内输入函数后，按下 Ctrl+Space 触发参数提示，查看形参名称与类型注解。
3、将光标悬停在符号上方，等待约 500 毫秒，弹出浮动窗口显示函数文档与源码位置。
五、配置格式化与保存行为
Clojure 社区普遍采用 cljfmt 或 zprint 进行代码风格统一，Calva 默认集成 cljfmt，可通过设置启用保存时自动格式化。
1、进入 VSCode 设置（Ctrl+,），搜索 calva.fmtOnSave，勾选启用。
2、搜索 editor.formatOnSave，确保该项也为启用状态。
3、在项目根目录创建 cljfmt.edn 文件，写入 {:indents {defn [[:inner 0]]}} 自定义缩进规则。
