如果你第一眼看到 caveman 这个名字大概会跟我一样以为这是个玩笑。一个文本编辑器叫穴居人听起来就像用石头刻字。但把 README 刷完之后我才发现这名字起得相当精准——它的作者摆明了要做一款返璞归真的编辑器不搞插件生态、不接语言服务器、不上遥测甚至不打算讨好所有人。整个项目就是用 C 语言加 ncurses 库写出来的一个小程序源码加起来不到一万行编译产物也就两三百 KB没有任何运行时依赖。它的定位很明确让你用最快的速度打开文件、改完、保存、走人。适合所有深度依赖终端的人也适合对编辑器加载速度有执念、看到 Electron 就头疼的那批老家伙。我上手用了两周今天把完整的体验、配置、踩坑记录都整理出来。1. caveman 到底是个什么样的项目1.1 项目定位给住在山洞里的人用的编辑器caveman 这个名字调侃的其实是现代编辑器依赖症。想想看现在的编辑器打开一个界面先给你来个欢迎页然后自动加载插件、检查更新、同步配置你还没来得及输一个字风扇已经开始转了。caveman 的思路完全反过来编辑这件事核心就是把字符放到正确的位置其他全是附加品。作者在项目文档里的原话大意是如果你需要的是一个 IDE你根本不该看这个仓库。caveman 只做文本编辑这一件事做得快、做得稳、做得干脆。它没有项目树、没有集成终端、没有代码补全弹窗、没有 minimap、没有 AI 助手。你打开它看到的就是光标、文本和一个状态栏。这个定位听起来很劝退但实际用下来你会发现它解决了一个非常真实的痛点在 SSH 进远程服务器、临时改配置、抢修一个线上问题的时候你需要的不是功能是不添乱。笨重的编辑器在这种场景下光是启动握手就得卡两秒而 caveman 几乎可以做到秒开。1.2 技术选型背后的逻辑为什么是 C 语言加 ncurses先说为什么是 C。作者的目标是零运行时依赖和极致的启动速度C 语言编译出来就是一块裸的可执行文件连标准库之外的东西都可选装载。相比之下用 Go 或 Rust 虽然也能做出小体积二进制但作者显然不在乎语言生态他在乎的是编辑器本身不该成为系统里最复杂的程序。ncurses 则是终端界面的标准答案。它帮你处理终端控制序列、窗口坐标、颜色等底层细节让程序在几乎所有 POSIX 终端里都能跑同时保留了每次按键都即时重绘的响应模式。很多极简编辑器选 ncurses 不选 tui 框架的原因很简单它足够老、足够稳、文档足够齐全而且你在终端里看到的每一帧画面都可以用最朴素的全屏刷新逻辑画出来不需要担心框架层的抽象泄漏。实测下来caveman 的启动耗时基本在 10 毫秒以内几乎是按回车的同时文本已经在屏幕上的状态。这种体感就是你半夜三点被叫起来改一行配置时最需要的东西。2. 从源码编译到第一次启动2.1 编译安装依赖、Makefile 与常见报错caveman 没有走 autoconf 那套复杂流程一个手写的 Makefile 就够了。编译过程非常简单git clone https://github.com/youknow-who/caveman.git cd caveman make sudo make install依赖只有三样gcc、make、ncurses 开发头文件。Debian/Ubuntu 系需要先安装sudo apt install build-essential libncurses-devFedora/RHEL 系则对应sudo dnf install gcc make ncurses-devel我在第一次编译时就遇到过两个典型问题。第一个是term.h: No such file or directory这是缺 ncurses 开发包导致的装上 libncurses-dev 就好。第二个是链接阶段报undefined reference to setupterm多半是系统里同时存在 ncurses5 和 ncurses6 的头文件混用最简单的处理方式是检查一下 ncurses 版本必要时把LIBS-lncurses改成-lncursesw因为新版 ncurses 的宽字符接口已经合到了主库里。注意这个项目对老系统比较友好CentOS 7 这类还停留在 ncurses5 的环境也能编过但你要是用了较新的 Ubuntu记得先确认pkg-config --libs ncurses的输出有些发行版默认给你的是 tick 掉宽字符支持的版本会导致后面中文显示有问题。2.2 启动、打开文件与第一印象安装完成后直接敲caveman会得到一个空白缓冲区敲caveman filename则是打开指定文件不存在时会按新文件处理保存时才真正创建。界面结构非常朴素顶部一行状态栏显示当前文件名、光标行列号和修改标记*表示内容未保存中间是大片编辑区底部一行提示栏平时显示普通提示输入命令时临时变成命令行。没有花哨的启动界面没有欢迎语进去就是干活的架势。第一次进去你可能和我一样有点不适应——它默认就是插入模式你按什么键屏幕上就出什么字不需要像 Vim 那样先按i。这个交互模型对新手友好对老手也不算坏事因为真正的高频操作并不依赖模式切换。3. 核心操作与快捷键拆解3.1 三组核心快捷键编辑、导航、命令caveman 的快捷键设计吸收了一点 Vim 的肌肉记忆但把它简化成了常驻插入 前缀命令的混合模式。普通情况下直接输入文字需要执行操作时再按对应快捷键不需要切模式也就不会出现按了半天发现还在 normal 模式的窘境。我整理了一张最常用的快捷键表功能按键说明光标移动Alth/j/k/l 或方向键按行/按字符移动快速移动AltCtrlh/j/k/l按单词或段落跳转保存Alts写入当前缓冲退出Altq有未保存修改时会提示撤销Altu一步一步回溯搜索/底部输入关键词回车跳转下一个匹配n搜索后继续向下找命令模式:底层留给了类 ex 命令行号开关Altn切换行号显示自动换行Altw切换折行显示这里最值得聊的是撤销。caveman 1.x 只有撤销没有重做作者给出的理由是撤销错了说明你根本不该撤销。这个设计看着任性其实是极简哲学的一部分——每多一个功能就多一份需要维护的心智负担和代码路径。实际使用中你会很快习惯用 Altu 把错误改回去然后重新输入正确内容并没有什么不便。3.2 命令模式与多文件处理:命令是这个编辑器里最接近 Vim 的地方。支持的命令不多但每一条都实用:w 保存当前文件 :q 退出 :wq 保存并退出 :e 文件名 打开新文件 :ls 列出所有打开的缓冲 :b 编号 切换到指定缓冲同时打开多个文件后Alt[和Alt]可以在缓冲区之间来回切换状态栏会显示当前文件在列表里的位置。这个设计让我想起了老派的 nano-pico 时代没有花哨的标签页、没有拖拽、没有预览但一个窗口对应一个缓冲的逻辑足够清晰而且因为缓冲区切换只是指针重排速度几乎可以忽略不计。有一点必须提醒Altq和:q在有未保存修改时会弹确认但如果你用了:q!这种强制退出不存在的caveman 压根没有这个命令。它的逻辑是你非要强退就去kill——确实符合它的风格很多激进的极简工具都这样。4. 配置与个性化一个 rc 文件的自我修养4.1 配置文件结构与加载顺序caveman 的配置方式是一个纯文本文件默认读取~/.cavemanrc也支持通过CAVEMANRC环境变量指定路径。语法是每行一条key value#开头是注释没有条件语句没有嵌套结构一眼能看完。支持的关键配置项说多不多说少也不少# ~/.cavemanrc 基本配置 syntax on # 开启语法高亮 tab_size 4 # 一个 Tab 显示为 4 个空格 expand_tab on # 用空格替换 Tab 键 show_line on # 显示行号 color_scheme dark # 深色配色 search_wrap on # 搜索到末尾后循环 undo_limit 5000 # 撤销历史最多保留 5000 步 cursor_style beam # 光标样式beam / block / underline这个配置文件最大的优点是可控没有隐式联动你开的每个选项代码里都对应一个明确的逻辑分支改完重启立即生效不像某些编辑器改个主题要去翻 JSON 嵌套结构。4.2 我的配置参考与调整心得基于实际使用我目前的配置是这样syntax on tab_size 4 expand_tab on show_line on color_scheme dark search_wrap on undo_limit 2000 cursor_style beam几个点说明一下。expand_tab on对 Python、Go 这类依赖缩进语义的语言是必须的能避免混用 Tab 和空格导致的恶心错误但如果你经常改 Makefile记得临时关掉它因为 Makefile 的规则行要求制表符开头自动替换成空格后直接报错。我处理 Makefile 时通常是先Altn确认状态再手动在配置里临时改成expand_tab off改完再切回来。undo_limit我压到了 2000不是因为省内存而是因为缓冲区的撤销栈来回跳转时超过一定步数后心理上会算了不撤销了重敲。小编辑器的美德就是让人敢按撤销键而不是把每一步都留到天荒地老。提示caveman 的配色和语法高亮数量很克制默认只支持 C/C、Python、Go、Rust、Shell、Markdown、JSON 这些常见格式。如果你打开一个冷门语言语法高亮干脆就不开它会很诚实地显示纯文本。别指望它有 Tree-sitter那不是它的方向。5. 常见问题与排查技巧实录5.1 终端兼容性按键被吞、颜色不对我在各种终端环境里用过 caveman遇到最多的问题集中在按键识别上。最典型的是方向键变成^[[A这种乱码或者是按 Alt 组合键没有反应。原因几乎都是终端模拟器没有正确开启应用模式或者TERM环境变量设置不对。最快的排查路径先跑echo $TERM确认是不是xterm-256color或screen-256color不是就改一下在 iTerm2、GNOME Terminal 里确认使用 Option 作为 Meta 键或发送 ESC 前缀的选项打开了如果实在不行装一个tmuxtmux 会帮你做一层终端序列的统一很多按键问题会直接消失。颜色显示不正常比如明明设置了color_scheme dark却一片灰白十有八九是 ncurses 在编译时没检测到 256 色能力或者是TERM值太旧。把终端类型设成xterm-256color后基本都能解决。5.2 中文输入与 UTF-8 的坑中文用户最关心的问题是能不能正常显示和输入中文。caveman 的缓冲区以字节为单位处理文本但只要你的 locale 是 UTF-8中文显示和输入都没问题。我踩过的唯一坑是在某些精简版容器镜像里LANG没设置或设成了C导致中文显示成乱码。解决办法是在 shell 配置文件里显式加一行export LANGen_US.UTF-8 export LC_ALLen_US.UTF-8另外要注意caveman 的光标移动是按字节实现的所以中文这种多字节字符在移动光标时可能会表现出一次跳半个字的错觉。实际测试下来它已经很克制但我还是建议在中文长文档里尽量用/搜索定位而不是狂按方向键——这不仅是效率问题也能避免在字节边界上操作导致误删半个字符。5.3 大文件、崩溃与没有交换文件的裸奔caveman 没有交换文件也没有自动保存这是它最穴居人的地方。好处是目录里永远不会冒出一堆.swp垃圾文件坏处是电源一断、终端一崩溃没保存的修改就彻底没了。我实测过一个 50MB 的日志文件打开约 1 秒内存占用 60MB 左右属于全量读入内存的模式。因为内部用 gap buffer 存文本连续编辑时性能很好但如果你开着语法高亮翻长行有一点点刷新延迟。处理超大文件的建议是关掉行号和语法高亮能明显提升滚动速度。我的实际做法是把 caveman 放进 tmux 里用这样即使本地终端不小心关掉服务器上的会话还活着下次tmux attach就能找回现场这是没有自动保存功能之后最可靠的补救手段。6. 二次开发从用工具到改工具6.1 源码结构一个编辑器该有的骨架caveman 的源码结构非常适合作为学习素材你几乎可以把终端文本编辑器这个经典项目浓缩到几个文件里caveman.c 程序入口、主事件循环 buffer.c 文本缓冲实现核心是 gap buffer input.c 键盘输入解析、快捷键映射 render.c 屏幕绘制、状态栏、语法高亮 command.c 冒号命令解析与执行 config.c 配置文件解析其中 buffer.c 里的 gap buffer 很值得展开说。它本质上是在缓冲区中间留一段空隙光标移动时把空隙整体平移插入和删除都在空隙边缘进行。这样光标附近的编辑操作时间复杂度是 O(1)而不是像字符串拼接那样每次都要全量复制。对于写一段、改一段的典型编辑场景gap buffer 比链表更紧凑、比数组更灵活这也是很多经典编辑器选择它的原因。主循环的逻辑也很清晰读一个按键判断是普通输入还是快捷键再决定是往缓冲里插字符还是调对应的命令函数最后统一触发一次渲染。没有事件总线没有插件钩子整个流程从头到尾只有一条直线。6.2 我对这个项目的整体评价与适用建议按我自己的分类caveman 适合三类人第一类是常在服务器命令行环境工作、需要快速编辑的运维和 DevOps第二类是讨厌编辑器配置膨胀、只想安安静静写点脚本的开发者第三类是刚开始学 C 语言、想找一个小而完整的开源项目读懂源码的初学者。它不合适的人也很明确重度依赖 IDE 功能的重构党、插件收集癖患者、以及一切认为编辑器万能的人。我实际用下来最舒服的组合是本地用 Vim 做重型编辑SSH 到远程服务器后一律用 caveman配合git diff查看修改、配合 grep 做检索轻量任务完全不卡手。它的代码就摆在你的机器上改坏了大不了重新编译这本身就是极简软件最迷人的地方——因为足够简单所以你敢动它、能理解它、也愿意在它身上花时间。最后分享一个我在使用中养成的习惯给 caveman 设一个超短的别名c。服务器上敲一个字母就能进入编辑状态少一层思考多一分从容。如果你手头正缺一个少即是多的编辑工具或者单纯好奇一个编辑器如果什么都不想要会长成什么样caveman 值得你抽一个下午折腾一下。