企业官网建设流程全解析

在程序员的世界里，caveman不是一个贬义词，而是一种态度：不要花哨的抽象，不要复杂的配置，要的是一把石斧就能解决问题。我搜了一圈，发现至少两个开源项目都用了这个名字，而且都是我日常离不开的东西——一个是Clojure社区的极简Web框架 Caveman，另一个是Emacs上的深色护眼主题 Caveman2。这两个项目放在一起看特别有意思：一个在重构后端开发的“手感”，一个在重塑盯代码时的“观感”，看起来风马牛不相及，骨子里却共享同一个审美——原始、直接、不装。

这篇我就顺着这个标题，把这两个叫“caveman”的项目彻底拆开：先说它们各自解决什么问题、为什么选这种设计，再给出一套可以直接照着做的安装和上手流程，最后把我在实际使用中踩过的坑、总结出的经验一并扔出来。如果你是写 Clojure 的，或者天天泡 Emacs 的，这篇能帮你少走不少弯路。

1. 项目背景与命名逻辑

1.1 为什么程序员爱用“caveman”给项目起名

起名这件事，程序员比当爹妈的还较真。caveman直译是“穴居人”，放到软件领域，天然带着一种“返璞归真”的暗示。你要给一个强调简单、原生、不依赖复杂生态的项目起名，还能有几个词比 caveman 更贴切？这就像我们平时说“石器时代方案”——看着原始，但真到了荒郊野外，石斧就是比电锯靠谱。

Caveman 框架的作者就是顺着这个思路走的，整个框架的定位从名字就能猜个大概：尽量少做抽象，把 Clojure 写 Web 应用最常用到的几个部分用最直接的方式暴露给你。同样，Emacs 那边的 Caveman 主题，用的是同一套语言逻辑——洞穴里的光线就是那种昏暗、发暖、低饱和的状态，不刺激眼睛，正好符合长时间盯代码的人对舒适度的追求。

这两个项目其实都属于那种“一眼看名字就懂定位”的项目。框架那边，你不需要像学 Rails 一样背一整套约定；主题那边，你不需要像调 Sublime 那样研究十几个配色变量。它们把复杂的东西用“原始”二字砍掉了大半，剩下的刚好是每天都要用的核心功能。

1.2 两个Caveman项目的定位差异与适用人群

Caveman 框架面向的是“想快速用 Clojure 起一个 Web 服务”的人。Clojure 本身属于 Lisp 家族，对新手来说本来就有门槛，如果再用上 Compojure、Reitit 这种功能全但概念多的路由库，学习曲线会变得更陡。Caveman 走的是另一条路：基于 Ring 保全了 Clojure 社区的标准接口，但路由写法极其朴素，默认模板生成的页面也就那么一两张，核心思路就是“你先把东西跑起来再说”。

Caveman 主题面向的是“每天要在 Emacs 里连续工作八小时以上”的夜行者。这类人不是不懂花哨的彩虹色主题，而是清楚知道：高饱和的蓝紫色块看久了眼睛会累，纯黑背景在暗光环境下反而刺眼。Caveman 的配色整体偏暖，背景带一点泥土感和火石感，长时间阅读代码时视觉疲劳明显轻很多。

所以这两个项目看似无关，受众却有高度重合——一个做后端的 Clojure 开发者，白天写接口，晚上调主题，本质上都是在跟“复杂度”较劲。这也是我写这篇的原因：把同一个词背后的两套方案讲清楚，你就能理解什么叫“好的工具是让人忘记工具的存在”。

2. Caveman框架：Clojure世界里的极简Web开发

2.1 框架定位与核心设计思路

Caveman 框架在 Clojure 社区里不算大项目，但定位非常清晰：它把 Web 开发收敛到“项目模板 + 路由宏 + 自带静态资源目录”这个级别。你不需要在框架层面理解 middleware 的嵌套模型，不用学一套 DSL 来描述 URL 映射，甚至可以不知道 Ring handler 到底是个什么东西，因为模板已经把主入口和启动逻辑全部写好了。

我第一次看到 Caveman 的代码时，印象最深的是它那套defroute宏。这个宏把路由表收敛成了最朴素的模式：一个路径、一个请求方法、一个返回函数。你不再需要像 Compojure 那样把各个路由包在routes宏里，再用context做前缀分组，直接平铺着写就够了。这样的设计在大型项目里可能显得不够灵活，但对中小型服务、内部工具、教学示例而言，反而省掉了大量概念包袱。

Caveman 官网和模板里总能看到一句话：“Caveman is watching you.”这算是个彩蛋，也是全项目精神的浓缩：你以为自己在用框架，实际上框架也在盯着你别把简单的事情搞复杂。项目默认页面是一张极简的标题页，没有多余装饰，上面写着欢迎语和几个示例链接，打开浏览器第一眼就知道框架跑通了没有。

2.2 五分钟快速创建一个Caveman项目

我以 Leiningen 为例，这是 Clojure 社区最经典的构建工具，Caveman 官方模板也是基于 Leiningen 的。先用一条命令生成项目骨架：

lein new caveman myapp cd myapp lein run

如果你本机已经装好了 JDK 和 Leiningen，这三条命令下来，浏览器访问默认端口就能看到框架的欢迎页。默认端口什么的我建议直接看生成的core.clj文件，里面一般会写明run-server的端口参数，避免凭记忆猜错。Caveman 默认生成的目录结构也很符合直觉，src下面是主逻辑，templates下面是页面模板，public下面是静态资源。

这个过程中最容易卡住的点是第一次lein run需要拉取依赖。Clojure 生态的依赖下载机制依赖 Maven 中央仓库，第一次跑可能等几分钟，别急着关终端。如果你在一个网络不太稳定的环境里，出现拉包超时也很正常，重试几次或者换镜像仓库都能解决。

跑起来之后，修改core.clj里的路由，保存刷新就能看到变化。Caveman 默认没有套热重载插件，虽然可以用lein-ring配合开发配置实现自动刷新，但说实话这个框架的定位就是“小步快跑、重启不心疼”，手动重启一次也就两三秒的事情，我觉得没必要为了省这一步而引入额外复杂度。

2.3 路由、控制器与模板：不搞魔法的“肉眼可见”

Caveman 的路由写法非常有辨识度。我用一段最简单的代码示例说明：

(ns myapp.core (:require [caveman.core :refer [defroute ok]] [ring.adapter.jetty :refer [run-server]])) (defroute "/" [] (ok "<h1>Home</h1>")) (defroute ["/hello/:name"] [name] (ok (str "<p>Hello, " name "</p>"))) (defn -main [& _] (run-server #'var? {:port 8080 :join? false}))

上面这段里面，defroute第一个参数就是路径样式，第二个参数列表里声明的变量会依次绑定到路径参数上。这个设计奇妙在：它没有引入任何“魔法”，你写["/hello/:name"]时，编译器就能看明白name是从 URL 里抽出来的，调试的时候不需要翻框架源码去猜参数是怎么注入的。我在实际使用中感受最明显的好处是，别人接我的代码时不需要我再解释一通框架机制，对着core.clj就能改。

模板方面，Caveman 官方推荐用 Selmer。Selmer 的语法跟 Django Template 很像，用过 Python 的人几乎没有学习成本。我习惯把所有页面放在templates目录，路由里用render函数返回渲染后的 HTML。这样做的好处是：页面结构独立出来，后端只负责提供数据，修改前端样式时不需要碰 Clojure 代码。对于写内部工具来说，这套组合已经足够了。

如果你要写接口而不是页面，Caveman 也支持直接返回 JSON。配合 Cheshire 库，几行代码就能把一个 Clojure map 转成 JSON 返回给前端。整个过程非常透明，你始终知道自己返回了什么、框架做了什么转换，不会像某些全家桶框架那样，一秒响应却看不清中间发生了什么。

2.4 一个完整小示例：用Caveman写一个“洞穴留言板”

为了让你更直观理解 Caveman 的开发节奏，我写一个内存版留言板服务。它虽然简单，但覆盖了 GET、POST、状态存储和内容渲染这四个最常见的场景。

(ns message-board.core (:require [caveman.core :refer [defroute ok render]] [ring.adapter.jetty :refer [run-server]] [ring.middleware.params :refer [wrap-params]] [clojure.string :as str])) (def messages (atom [])) (defroute "/" [] (render "index.html" {:items @messages})) (defroute "/add" [] (let [msg (get-in (ring.middleware.params/params-request {}) [:params "msg"])] (when (not (str/blank? msg)) (swap! messages conj msg)) (ok "added"))) (defn -main [& _] (run-server (wrap-params #'var? ) {:port 8080 :join? false}))

这个示例里，我用atom做全局状态，留言就存在内存里，服务重启就丢失。但这恰恰是 Caveman 的风格：你不需要为了“写个例子”拉起 MySQL，不需要折腾 ORM，先用最简单的方案验证逻辑。真实项目里把它换成数据库，也只是把swap! messages conj msg换成一条 SQL 的事。

这里的render函数用的是 Selmer，对应模板里我写了一个简单的 for 循环，把items遍历输出成列表。整套流程下来，项目骨架加业务代码，大概几十行就能搞定。我带过几个刚接触 Clojure 的朋友体验这个框架，他们的反馈都是“居然绕过了那些让人劝退的抽象”。这其实正是 Caveman 作为教学工具的价值。

2.5 为什么在大型项目里我也愿意保留Caveman

有人可能觉得，这么简单的框架，拿去做正经项目是不是草率了？我的观点是，项目是否“正经”取决于业务复杂度，而不是框架名气。如果你要写的是给团队内部用的报表系统、运维小工具、定时任务的管理后台，那 Caveman 这种“一眼到底”的框架反而更好维护。代码量小，因果关系清晰，三年后再回来改也不会看着陌生。

当然我也承认它有短板。如果你需要 WebSocket、复杂鉴权、细粒度中间件，Caveman 不会拦着你用 Ring 生态的东西，但它并不会给你现成的答案。这时候你更适合用 Reitit 甚至直接用 Ring 手写中间件链。但反过来，如果你的目标是“别折腾框架，快点上线”，Caveman 提供的这套极简单点能满足八成场景。它在生产里的价值，不是取代大型框架，而是让你重新思考：很多东西真的需要那么重吗？

3. Caveman主题：给Emacs夜行者的低刺激配色

3.1 配色背后的护眼逻辑与视觉理念

Caveman 主题在 Emacs 社区里属于小众但口碑扎实的那一类。用它的人往往是从 Doom、Solarized、Zenburn 这些主题一路换过来的，最后停在 Caveman 多半不是因为“好看”，而是因为“舒服”。它的背景不是纯黑，而是带一点赭石色的深褐，接近洞穴岩壁在火把下的观感；前景文字也不是刺眼的纯白，而是一种被火光烤过的浅米色。

从色彩心理学上说，暖色调的暗色背景比冷色调的纯黑背景对瞳孔更友好。纯黑背景让瞳孔被迫放大，反而让蓝紫色的高亮色块更刺眼；而暖褐背景让黑色文字的对比度下降，眼睛的调节压力更小。我用 Caveman 半年多，最明显的变化是晚上写代码时干眼感明显轻了，虽然也有一部分原因是字体和屏幕亮度调整了，但主题配色的功劳绝对不小。

Caveman 主题的高亮策略也很讲究，关键字用橙赭色，字符串用苔藓绿，函数名用砂岩色，整体饱和度都不高。不会像某些主题那样每个 token 都抢着冒头，而是让主要代码的自然层次浮现出来。如果你写的是 Lisp 系语言或者 Python，这种克制会让代码结构一眼扫过去就清晰，因为视觉噪音少了，语义层次自然浮出来。

3.2 安装与启用：use-package、MELPA与手动配置

我推荐用use-package来管理 Emacs 配置，这是目前最主流的方案。Caveman 主题在 MELPA 上通常以caveman2-theme或类似名字收录，你可以先试着搜索确认，如果搜不到直接从 GitHub 拉取仓库手动配置也完全可行。下面是一段典型的安装配置：

(use-package caveman2-theme :ensure t :config (load-theme 'caveman2 t))

如果你的网络条件不适合直接拉 MELPA，也可以手动把主题仓库克隆到本地：

git clone https://github.com/你的仓库/caveman2-theme.git ~/.emacs.d/themes/caveman2

然后在配置里加上add-to-list 'custom-theme-load-path "~/.emacs.d/themes/caveman2"，再load-theme就行。加载之后，如果发现颜色没有完全生效，优先检查是不是有旧主题覆盖了变量。Emacs 的主题加载顺序是后加载的覆盖先加载的，所以最好确保 Caveman 是配置里最后一个load-theme。

还有一个小细节，如果你用的终端模拟器不支持真彩色，Caveman 的效果会打折扣。比如在默认 256 色环境下，暖色渐变会被压缩成几档，某些注释色块会变得灰扑扑的。如果你常年用终端版 Emacs，我的建议是优先保证终端支持 truecolor，比如用 Kitty、Alacritty 或新版 GNOME Terminal，都能获得接近 GUI 的显示效果。

3.3 定制技巧：背景色、高亮与Mode Line调整

大众对主题的理解是“装好就完事”，但实际上这种护眼主题的最佳状态几乎都需要微调。Caveman 的默认背景对某些屏幕来说偏暗，我喜欢在它基础上稍微调亮一点，操作方法是在加载主题后设置face-background：

(load-theme 'caveman2 t) (custom-set-faces '(default ((t (:background "#211C18")))))

你还可以调整 mode line 的样式。Caveman 默认的 mode line 不花哨，但如果你想要更明显的当前 buffer 提示，可以在配置里把mode-line-active的背景改成深灰蓝，效果会比默认更醒目。我这边的做法是把 mode-line 的字体调小一档，让底部信息条看起来更收敛，不跟代码区抢注意力。

对于注释的颜色，我一般习惯再降一点对比度，因为注释是次要信息，太亮反而会干扰阅读主代码。类似这样：

(custom-set-faces '(comment ((t (:foreground "#6E6A66")))))

微调的思路是：主题给你一个不刺激的底子，你再根据自己屏幕的亮度、环境光、甚至个人视力度数去修正细节。同一台机器，白天和晚上对背景亮度的需求都不一样。我一般会准备两个亮度版本，白天用默认的 Caveman，夜间用我调暗过的变体，切换起来也就是一条 emacs-lisp 函数的事。

3.4 适合搭配的字体与终端配置

主题只是视觉环境的一半，另一半是字体。Caveman 的暖色画面适合搭配偏圆润的等宽字体，我用过 JetBrains Mono、Fira Code，也用过 Source Code Pro，最后长期留在 JetBrains Mono。这倒不是因为它比别的字体更好看，而是它在中等字号下仍然能保持字形的清晰度，与 Caveman 那种稳重的暗色调很搭。

如果你处理中文注释，再加上中文字体，推荐把默认字体配置成中西文混排组合，例如：

(set-face-font 'default "JetBrains Mono-13") (set-fontset-font t 'han (font-spec :family "霞鹜文楷" :size 15))

这样英文代码用衬线感更清晰的等宽字体，中文注释用柔和的楷体，整体视觉协调度会提升不少。我在换字体之后发现，代码似乎比之前“安静”了，注意力更容易集中在逻辑上，而不是被一个个张扬的字形带走。

终端方面，如果主题在 GUI 里看着舒服但在终端里发灰，可以先确认终端的背景色设置。有些终端会强制覆盖背景色，你需要把终端背景调成透明关闭，或者在终端配置里显式把背景色设为#1C1917之类的深褐，才能跟主题保持一致。

3.5 常见问题：颜色不生效、终端发灰、高亮缺失

我实际使用 Caveman 主题时踩过几个坑，值得一条条说清楚。第一次装完，代码区的背景根本没变，问题出在我同时开了modus-themes的某些自动切换配置，两个主题在加载时互相打架。解决方案很简单：认真检查custom-theme-load-path和custom-enabled-themes，保证 Caveman 在最后加载。

第二个坑是终端下颜色和 GUI 差很多。这个问题一般在于终端没有把TERM环境变量正确设置成xterm-256color，或者终端模拟器只支持八色。我后来换了支持 truecolor 的终端，再配合在.bashrc里加上export COLORTERM=truecolor，显示效果就跟 GUI 几乎一致了。

第三个坑是 Org-mode 里的标题和代码块颜色有点奇怪。Caveman 的重度使用者很多会拿它写技术笔记，Org 里的大标题、TODO、代码块如果颜色层次不清，体验会差很多。我的经验是给org-level-1、org-level-2这类 face 单独指定颜色，思路跟调 mode line 一样，把次要信息压暗，只让真正的待办事项醒目即可。

这些问题的排查思路都一致：先确认主题本身加载了，再检查有没有其他配置覆盖，最后判断是 Emacs 层面的问题还是终端模拟器的问题。把它们按顺序捋一遍，大部分颜色异常都能快速定位。

4. 避坑指南与实操心得

4.1 Clojure侧：依赖拉取、端口占用和热重载问题

Caveman 框架上手快，但第一次跑项目时还是有三个高频问题。第一是lein run卡在依赖下载上，除了网络原因，还可能是本地 Maven 仓库缓存冲突。遇到这种情况我一般先清一下~/.m2/repository里相关的目录再重新拉，实在不行换个仓库源。第二是端口被占用，Caveman 默认端口要是和别人开发中的服务冲突，启动就会报错，改端口只需要找到run-server调用处改参数，没有复杂的配置文件。

第三是热重载问题。Caveman 模板没有默认集成lein-autoreload这类东西，我早期每次改代码都手动重启，后来总结出一个小技巧：用lein run配合 tmux，改完代码切到运行窗口按 Ctrl-C 再上下键回车重启，整个过程不超过三秒。这种方式比装一堆热载插件更贴近 Caveman 的理念，也不容易因为热载状态残留下奇怪的 bug。等你的项目长大到重启成本不可接受时，再考虑引入 Clojure SPI 或者lein-ring也不迟。

4.2 Emacs侧：主题覆盖、终端真彩色和Org-mode适配

Emacs 主题的问题我在前文已经拆了几个，还有一个特别隐蔽的：如果你启用了global-display-line-numbers-mode，在某些终端里行号会因为背景色透明而看不清。Caveman 对这种边缘情况的处理不算完美，你需要给line-number这个 face 单独设置背景和前景色。类似这种小修小补，一篇文章是写不完的，但掌握了“先定位覆盖关系，再针对 face 调整”的思路，就没什么能难住你。

我自己踩过最深的一个坑是，在远程服务器上用 tramp 打开文件时，Emacs 会重新加载主题，而远程环境的终端没有 truecolor，导致原本纯净的暖褐色变成一团灰。后来我在 tramp 配置里强制把tramp-terminal-type设成带 truecolor 的终端类型，问题才解决。如果你也习惯用 Emacs 写远程代码，这个坑大概率会遇到。

4.3 对“原始”二字的重新理解

玩了一圈 Caveman 框架和 Caveman 主题之后，我最大的收获反而不是技术细节，而是对“原始”这个概念有了新的理解。原始不代表简陋，更不代表倒退，而是把工具砍到只剩必要部分后，让人的注意力真正回到问题本身。框架那边，它提醒我不需要每个 Web 服务都上全套工程化；主题那边，它提醒我视觉舒适度比花哨的配色更重要。

这两个项目都可以说是“带着克制心写出来的”。当你习惯了这种风格，再回头看那些什么都想塞进去的框架、颜色多到像霓虹灯的主题，就会明显感觉到一种“噪音”。这也是为什么我总说，Caveman 从来不是一个框架或一个主题的名字，它是一类开发者的审美标签。如果你也觉得工具应该是被忽略的、而不是被注视的，那你大概率会喜欢这两个项目。

5. 后续能怎么往下玩

5.1 把Caveman框架升级成完整Web应用

Caveman 只是起点，不是终点。用它搭好第一版之后，你可以按自己的需求逐步加东西：数据库层用next.jdbc加连接池；前端用 Reagent 配一个简单的 SPA；任务调度用quartzite或直接写个 future 轮询。每一步都可以独立进行，不会因为框架体积太小而阻碍你。相反，正因为底子简单，每加一层你都能清楚地知道它在整个请求链中的位置。

我自己的一个内部小项目就是这条路走出来的：先用 Caveman 写了十几个接口，后来加了 SQLite 做数据持久化，最后又引进了 Selmer 做页面。整个代码库到现在还是维持在一千行以内，维护成本基本可以忽略。如果你的项目体量类似，这么走会很舒服。

5.2 把Caveman主题改造成个人护眼配方

主题也是一样，Caveman 是底子，你可以在这个底子上修修改改，形成一套属于自己的“配方”。比如把高亮颜色往偏红方向调一点，或者把注释亮度降得更低，都是我实际做过的事情。Emacs 的 face 系统足够灵活，你不需要新写一个主题，只需要在加载主题后叠加几行custom-set-faces，就能拥有一个个人版的 Caveman。

如果你愿意更进一步，可以把这些配置抽成一个独立的小函数，绑定到一个快捷键上，在一键深色、一键浅色之间切换。白天用浅色版本，晚上切到洞穴版，这比单纯一个主题覆盖全天场景要实用很多。当然，无论怎么改，都要记住一个度：别把是修饰性的颜色加得太多，否则就失去 Caveman 本身的意义了。

5.3 最后分享一条个人经验

从我的日常体验来看，Caveman 框架和 Caveman 主题都不是“看一眼就惊艳”的项目，但都属于“用了就离不开”的类型。如果你正在找一套低门槛的 Clojure Web 方案，或者正在为眼睛的干涩发愁，不妨花一晚上把它们装起来试几天。工具这东西，合不合适只有身体和手感知道。反正我自从把这两样东西配齐之后，写代码时几乎不再注意到“框架在哪儿、主题长什么样”了，这种状态，大概就是工具最好的状态。