Calva插件未正确配置或启用会导致VS Code中Clojure项目缺少代码补全、REPL集成与断点调试支持；需安装Clojure CLI或Babashka，再通过VS Code扩展市场安装Calva，依步骤完成REPL启动、代码跳转、调试配置及格式化设置。
如果您在 Visual Studio Code 中开发 Clojure 项目，但无法获得代码补全、REPL 集成或断点调试支持，则很可能是 Calva 插件未正确配置或未启用。以下是针对常见使用场景的具体操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装与基础配置
Calva 是 VSCode 中专为 Clojure 设计的扩展，依赖于 Clojure CLI 工具链提供语言服务。安装前需确保系统已安装 Clojure CLI 或 Babashka，并在终端中可执行 clojure 或 bb 命令。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X）。
2、在搜索框中输入 Calva，找到由 BetterThanTomorrow 发布的官方插件。
3、点击“安装”，安装完成后重启 VSCode。
4、新建或打开一个包含 deps.edn 或 bb.edn 的 Clojure 项目文件夹。
二、启动项目 REPL
Calva 通过连接本地或远程 REPL 进程实现交互式开发。默认使用 clojure -M 启动基于 deps.edn 的 REPL，若项目使用 Babashka 则自动适配 bb 命令。
1、在 VSCode 中打开项目根目录下的任意 .clj 文件。
2、按下 Cmd+Shift+P 打开命令面板，输入 Calva: Start a Project REPL and Connect 并回车。
3、Calva 将自动检测项目类型并执行对应启动命令，底部状态栏显示 Connected to nREPL on localhost:XXXX 即表示成功。
4、此时可在编辑器中选中表达式，按 Cmd+Enter 加载到 REPL；或在集成终端中直接输入 Clojure 表达式求值。
三、代码导航与跳转
Calva 提供语义级符号解析能力，可识别命名空间、函数定义及宏展开结果，依赖项目已成功加载且 REPL 处于活跃连接状态。
1、将光标置于任意函数名（如 map 或自定义函数）上。
2、按下 Cmd+Click（或右键选择“转到定义”），Calva 将跳转至该符号的源码位置。
3、若跳转失败，检查是否已执行过 Calva: Load Current File（Cmd+Alt+C L），确保当前文件已被加载进 REPL 上下文。
4、对宏调用使用 Calva: Expand Macro at Cursor（Cmd+Alt+C X）可查看宏展开后的形式。
四、断点调试配置
Calva 支持在 Clojure 源码中设置断点并单步调试，底层通过 nREPL 的 debug middleware 实现，要求项目依赖中包含 cider/cider-nrepl 或兼容中间件。
1、确认项目 deps.edn 的 :aliases 中已声明含 cider-nrepl 的配置，例如 :dev {:extra-deps {cider/cider-nrepl {:mvn/version "0.28.7"}}}。
2、启动 REPL 时选择带调试支持的 alias，例如执行 Calva: Start a Project REPL and Connect (with Jack-in) 并在提示中选择 dev。
3、在 .clj 文件行号左侧灰色区域点击设置断点，出现实心红点即生效。
4、触发断点的方式包括：在 REPL 中调用含断点的函数，或使用 Calva: Evaluate Top Level Form（Cmd+Alt+C E）执行当前顶层表达式。
五、格式化与括号匹配
Calva 内置 Parso 格式化引擎，支持实时格式化与结构高亮，无需额外安装 Paredit 插件即可完成智能括号管理。
1、打开任意 .clj 文件后，Calva 自动激活括号匹配高亮，光标位于括号内时会以 绿色背景 显示对应括号范围。
2、选中一段代码后按下 Cmd+Shift+I，Calva 将按社区标准（如 cljstyle）自动缩进与换行。
3、若需禁用自动格式化，进入 VSCode 设置，搜索 calva.fmtOnSave，将其设为 false。
4、使用 Cmd+Alt+C O 快速折叠/展开当前顶层表单，提升嵌套结构阅读效率。
