Sublime如何配置Clojure环境？Sublime运行Clojure代码教程

Sublime如何配置Clojure环境？Sublime运行Clojure代码教程

先说一个核心事实：Sublime Text本身并不运行Clojure代码。它的角色更像一个高效的“信使”，负责把代码发送给外部的REPL，或者调用你本地的clj命令。真正的执行工作，完全依赖于你本地安装好的Clojure CLI（也就是clj）和JVM。根据经验，配置失败的原因往往高度集中：环境变量没配对、混用了不同的构建工具，或者缩进格式用了Tab而非空格——这三类问题，几乎能覆盖八成以上的失败案例。

clj 命令在终端能跑，但 Sublime 里报 command not found

这通常不是Sublime的“锅”，而是它的子进程没能正确继承你Shell里的环境变量，尤其是那个关键的PATH。macOS或Linux用户如果用的是zsh，但Sublime是从Dock直接启动的，就容易遇到这个问题。Windows用户则常常因为安装路径包含了空格或中文字符，导致系统找不到clj.bat。

• macOS/Linux用户：别直接点击图标启动。试试在终端里执行open -a "Sublime Text" --args或者直接用subl命令来启动，这样能确保环境变量被正确带入。
• Windows用户：最稳妥的办法是把clj安装到一个纯英文、无空格的路径下，比如C:/tools/clojure。然后，在你使用的插件设置里，显式地填写完整路径，例如："clojure_cmd": ["C:/tools/clojure/clj.bat", "-M"]。
• 通用验证方法：在Sublime里打开Python控制台（快捷键Ctrl+`），输入import os; os.environ.get("PATH")，看看输出的路径字符串里是否包含了clj所在的目录。

Ctrl+Enter 没反应，或发送代码后 REPL 无输出

这是新手最容易踩的坑：以为安装了插件就等于自动连上了REPL。其实，像SublimeREPL、ClojureSublimed、Conjure这些插件，本质上都是“客户端”。你必须先手动启动一个nREPL服务端，它们才能连接上去进行通信。

• 首先，确保你的项目根目录下有一个deps.edn文件，哪怕里面只写一行{:paths ["src"]}。
• 然后，在终端里进入项目根目录，运行clojure -M:nrepl（前提是你的deps.edn里已经定义了:nrepl这个别名）。注意，尽量避免使用lein repl，因为像Conjure这类插件对它的兼容性可能不太好。
• 对于ClojureSublimed用户：按Ctrl+Shift+P，输入ClojureSublimed: Start nREPL来启动，这一步不能跳过。
• 如果插件还是提示连接失败，记得检查conjure.edn或插件设置里的:host和:port，是否与启动nREPL时终端输出的地址和端口一致（默认通常是localhost:5555）。

括号不匹配、缩进错位、defn 后 Tab 不展开模板

在Clojure里，缩进不仅仅是代码风格问题，它直接关系到语义。缩进错一个空格，clojure-lsp可能不会报错，但REPL加载时很可能直接抛出一个ja va.lang.RuntimeException: Unable to resolve symbol的错误。

• 关闭Sublime的自动检测缩进功能：在Preferences → Settings – Syntax Specific中（确保当前语法是Clojure），添加"detect_indentation": false。
• 强制使用4个空格：同时设置"tab_size": 4和"translate_tabs_to_spaces": true。
• 如果现有文件里混入了Tab：全选代码，然后Ctrl+Shift+P，输入Convert Indentation to Spaces进行转换。之后最好再手动搜索一下→（这个箭头符号通常代表隐藏的Tab字符），确保清理干净。
• 想让Tab键自动展开defn等代码模板：需要在ClojureSublimed的设置中开启"enable_snippets": true，并确认Tab键没有被AutoFileName或Emmet等其他插件劫持。

Build System 能跑单文件，但无法热重载或加载依赖

需要明确一点：Build System的执行模式是一次性的脚本执行。每次按Ctrl+B，它都会新建一个JVM进程，冷启动慢，状态不共享，而且默认不读取deps.edn里的别名配置。因此，它更适合用来跑测试脚本，而不是作为日常开发的主力工具。

• 日常开发请务必使用REPL：这才是Clojure开发的精髓。写完一个函数如(defn foo [] :ok)，把光标放在括号内按Ctrl+Enter，函数立刻被求值，结果瞬间返回，这才是高效的工作流。
• 如果某些场景下非得用Build System，建议优先使用clojure-sublimetext这类插件自带的构建系统，它默认调用clj -i，比自己手写JSON配置要稳定得多。
• 如果需要通过Build System加载项目依赖，那么构建命令必须显式带上-Sdeps参数。例如：["clj", "-Sdeps", "{:deps {org.clojure/clojure {:mvn/version \"1.12.0\"}}}", "-i"]。
• 注意命名空间一致性：Build System默认会根据文件名推导命名空间。如果你的文件叫foo.clj，那么里面的命名空间声明必须是(ns foo)，否则load-file时会报错。

最后，也是最容易被忽略的一个关键点：几乎所有Clojure插件（包括Conjure、ClojureSublimed、SublimeREPL）都依赖一个前提——你必须在Sublime中打开整个项目文件夹，而不是仅仅打开一个孤立的.clj文件。只有这样，插件才能扫描到项目根目录下的deps.edn文件，从而启动正确的classpath，并为代码跳转、符号索引提供支持。这一点在文档里常常一笔带过，但实际开发中，它卡住的新手数量可能最多。