阅读约 17 分钟第 5 篇
为什么讣告用 Go,而不是 Rust
讣告第一版计划推荐的是 Rust,第一晚就改成了 Go,之后代码涨到 1.36 万行和 6.4 万行时,又两次认真算过要不要重写。这篇按当时的记录,讲推荐 Rust 的理由为什么没用上,留在 Go 靠的是哪几条约束,以及借着追问补上的模糊测试、基准和并行测试。

讣告(命令 obit)给文件设定寿命,到期下葬进可以复活的墓地,主要给 AI agent 用。它的第一版计划推荐用 Rust 写,第一晚我们已经建好了 Cargo.toml 和两个空入口,几分钟后又换成了 Go。之后的十二天里,代码先后涨到 1.36 万行和 6.4 万行,两次有人认真问要不要改成 Rust,两次算完账都留在 Go。
决定这件事的不是语言偏好,而是这类工具的风险落在哪里。一个替 agent 管文件生死、拦危险删除命令的工具,最怕的是认错文件和读错 shell 命令,不是内存出错。守住这两件事靠的是测试,尤其是要反复重新编译的变异测试,所以编译速度和解析库的成熟度,比语言本身的特性分量更重。

第一晚:推荐 Rust 的那条理由后来没用上
2026 年 11 月 7 日晚上,项目还叫 Lifespan(命令 ttl),定位是 Windows 上给文件设倒计时的小工具。agent 写的第一版计划推荐 Rust 全栈,理由只有一条:Windows 11 新式右键菜单要一个加载进 explorer.exe 的 COM DLL,Go 和 .NET 的运行时不适合放进资源管理器进程,而 Rust 配合 windows-rs 可以把命令行、后台进程和这个 DLL 放进同一个 Cargo workspace。备选方案是命令行和后台进程用 Go,只把 DLL 交给 Rust,代价是维护两种语言。
22:16,负责人回了一句「按你说的,go」。agent 把它读成了「按推荐开干」,查了本机的工具链(Rust 1.96,GNU 工具链,没有 MSVC)和 windows、fs4、chrono 几个依赖的版本,开始写 edition 2024 的 Cargo.toml 和 src/bin/ttl.rs、src/bin/ttld.rs 两个空入口。这时负责人接连又发了两条:「用GO好点」「为啥rust」。agent 删掉了刚建的空骨架,计划书里的语言一节改成:
用 Go。Win11 新右键菜单需要加载进 explorer.exe 的 COM DLL,Go 运行时不适合放进资源管理器进程,到 M2 时单独用 C++ 或 Rust 写一个很小的 DLL,只负责调用
ttl.exe。
22:30 之前,第一阶段就用 Go 写完了:按 NTFS 文件 ID 认文件,通过 IFileOperation 删进回收站,add、list、extend、cancel、sweep 五个命令,17 个测试,其中 16 个通过,操作真实回收站的那一个要设环境变量才跑。22:46 左右,方向又改成「agent 优先、跨平台」:agent 常常跑在 Linux 容器、WSL 或远程机器里,我们自己的 Codex 就跑在 WSL 里,所以 macOS 的废纸篓和 launchd、Linux 的 freedesktop 回收站规范和 systemd --user 都要接上。Go 的交叉编译从加分项变成了必需。
那个 COM DLL 最后没有写。讣告的右键菜单用的是经典的注册表方式,在 Windows 11 里出现在「显示更多选项」下面。第一版计划推荐 Rust 的唯一理由,实际上从来没有用上。
1.36 万行时:四条约束
11 月 8 日 13:53,项目在 M2b 的审查循环里(写完代码,两个审查员并行审,修,再审),负责人问:「要不要改成rust?」当时有大约 1.36 万行产品代码和 1.7 万行测试,经过了 22 轮审查。两分钟后,负责人又把问题推进了一步:「假如我把这个项目写进简历,人家问我,为什么用go,而不是rust,C++,typescript,我要怎么样回答?我能不能利用好go的优点?」
讣告装在用户的机器上,agent 每写一次文件、每执行一次删除,都会拉起一个 hook 进程。照这个场景,语言要满足四条约束。
第一条是分发和启动。要单个二进制,不依赖任何运行时,冷启动要快。hook 每次都是新进程,Node 冷启动慢,还要用户先装 Node,TypeScript 因此排除。
第二条是直接调用系统接口。讣告要按 128 位文件 ID 核对身份,在同一个打开的句柄上完成改名,还要通过 COM 接口把东西送进回收站。Go 用 x/sys/windows 加 syscall.SyscallN 就能直接调用 Win32 和 COM,internal/winfs/recycle_windows.go 直接按 COM vtable 调 IFileOperation,整个仓库没有一处 import "C"。C++ 也做得到,但构建、分发和内存安全的成本更高。
第三条是风险在语义上,不在内存上。要防的是误删、检查和移动之间的竞态窗口、文件身份被替换,Rust 的借用检查对这类问题帮助有限,靠的是测试。Go 的测试工具链在这里很直接:每个测试包的 TestMain 把用户目录指到临时目录,go test -overlay 做编译级的变异测试,证明每一道安全检查真的有测试守着。那 1.36 万行背后是 22 轮审查加固过的逻辑:按文件 ID 核对身份、在同一个句柄上改名、COM 调回收站、墓地清单和崩溃恢复、删除护栏的分词。换语言等于全部重写一遍,任何一处细微差别都可能变成误删,审查得从头再跑十几轮。
第四条是性能瓶颈不在语言。hook 是短命的进程,GC 基本不会触发;obit.exe 约 7 MB,obitd.exe 约 6 MB;Go 自己启动只要几毫秒,真正慢的是逐个启动 git 子进程(每个几十毫秒)和磁盘 I/O。Rust 的 toml_edit 能保留格式改 TOML,但我们只在 Codex 的 config.toml 里管一个带标记的块,已经能用。
这里还有一条退出条件:讣告需要作为库嵌进别的 Rust 程序,或者遇到某个只有 Rust 才有、又绕不开的能力,那时再重新考虑。
同一个下午负责人还问:「账本写入不能弄成那种,额,就是,一个小程序接住所有的命令,然后这个小程序去做串行吗」。这是成熟的单写者模式,用 Go 写也自然:常驻进程里一个 goroutine 独占账本,请求从 channel 进来,进程之间走 Windows 命名管道。我们当时没有做。每个命令自己抢文件锁、拿到锁才读改写账本,在正确性上已经和单写者等价,差别只在性能;而 obitd 当时是每 5 分钟跑一次的定时任务,并不常驻。为它不在的情况留后备路径,文件锁还得保留,等于维护两套路径,另外还要处理管道权限、当前目录和会话 ID 随请求传递、升级后新旧版本协议不一致。等有了常驻进程,再让它当快路径,文件锁继续兜底。
借着追问,把 Go 的工具链用起来
回答「能不能利用好 Go 的优点」时,我们回头核对了代码。用上的有零 cgo 调系统接口、按 _windows.go / _other.go 分平台文件、go:embed 把 SKILL.md 打进二进制、用 context 控制超时(每次调 git 最多 15 秒,hook 内所有加锁等待合计不超过 1 秒)、官方 MCP Go SDK 和 -overlay 变异测试。没用上的更多:模糊测试 0 个,基准测试 4 个,生产代码里 goroutine 0 个,t.Parallel() 0 个,全量测试要跑两分多钟;交叉编译也还不通,cmd/obit 直接依赖了 Windows 的包,GOOS=linux 编译不过。
负责人同意之后,我们在 M2b 审查收尾时插进一段「Go 能力整理」,11 月 9 日到 10 日做完,顺序是先量,再模糊,再改,改完测试数量和结果不变,原有的变异检查照样抓得到。
基线在同一台机器上量(Ryzen 9 7845HX,Go 1.26.4,同机还有其他 worker 在跑)。go test ./... 墙钟 172 秒;1000 个条目加 1000 条墓地记录时,obit list 190 毫秒,obit stats 163 毫秒,obit graveyard --json 432 毫秒。hook 的中位数和 p95:
| 场景 | 进程内 | 真实 obit.exe hook claude |
|---|---|---|
| 已同意的项目里写文件后(PostToolUse) | 201 / 294 毫秒 | 306 / 338 毫秒 |
| 还没同意的项目里写文件后(生成提议) | 97 / 123 毫秒 | 231 / 260 毫秒 |
| 会话开始(冷启动 / 恢复) | 103 / 24 毫秒 | 211 / 144 毫秒 |
| Stop | 0.5 毫秒 | 127 毫秒 |
| 删除护栏 PreToolUse | 0.9 到 1.9 毫秒 | 未单测 |
模糊测试覆盖所有解析不可信输入的入口:.obitrules 规则、墓地清单、时长和 --at、Claude 和 Codex 的 payload 与补丁、Codex 的 TOML 标记块、有序 JSON、删除护栏,共 11 个目标。派给 worker 的要求是每个目标除了不 panic,还要断言有意义的性质:解析成功的结果再序列化、再解析要得到同样的值;清单核对不接受墓地外的路径;不把非第 0 列的行当成补丁的文件头;标记块外面的内容原样保留。每个目标至少跑 2 分钟,合计约 2000 万次执行,找到两个问题。一个是 .obitrules 的字符范围:[.-0] 在 ASCII 里包含 /,会跨过目录分隔符匹配,扩大自动登记寿命的范围。另一个是奇数个反斜杠接换行的 bash 写法被删除护栏误拦。
之后照着基线改。已同意的项目里写文件后少问一次 Git,进程内从约 180 毫秒降到约 88 毫秒,真实进程从约 490 毫秒降到约 300 毫秒。批量收割原来每下葬一个条目,都要在账本写锁里把整本账本重写、落盘一次,写入量随条目数平方增长,每次两次 fsync。改成一批最多 32 项、一个事务以后,每一项照原样复核,中断由清单恢复:一次 obit reap 1000 个到期条目从约 100 秒降到 19.5 秒,后台火化 1000 项从 78 秒降到约 4 秒,自动登记的条目 1000 项从 108.7 秒降到 14.4 秒。测试钩子改成注入,425 个顶层测试和 97 处子测试改成并行;生产代码只在墓地大小统计这类安全的地方用 goroutine,账本写入和下葬保持串行。交叉编译和打包后来在 M7 做完,Linux 的 CI 跑上了 -race。
6.4 万行时:编译速度和 bash 解析器
11 月 19 日晚上,一位朋友看了项目后问:「有考虑rust实现吗」。负责人说不喜欢编译太久。朋友觉得「一个命令行小工具编译不是很久」,「其实最大的优势是写cli时候的可读性」。负责人又说 Rust 没有配套的 bash 解析器,朋友问「为什么要bash解析器」,并说「命令行本身不需要遵循bash语法」,「-delete这个写法就不遵循」。
这几句话碰到了两个容易被看轻的地方。
先说编译。讣告这时已经不是小工具,里面有常驻进程、图形界面、26 种 agent 的 hook、MCP 服务、资源管理器右键菜单和大量 Windows 句柄与 COM 调用。更要紧的是变异测试:把源文件里的一处安全检查换成坏掉的版本,编译,跑测试,测试必须失败。每个变异体都要重新编译一遍。上面那张截图里,编译一个变异体、链接成 26 MB 的程序用了 3.1 秒,所以几百个变异体跑得动,整组 MCP 变异在空闲机器上约 6 分钟,CI 上拆到 8 台机器并行。在当晚估算的 Rust 版本里,一次完整编译要几分钟,每个变异体都要等增量编译。这里的编译速度不是口味问题,它决定安全测试跑不跑得起来。
再说 bash 语法。-delete 用单横线是 find 自己的参数约定,bash 不管参数长什么样,只是把这个词原样交给 find。但一整条命令里哪些是文字、哪些会被执行,完全由 shell 的引号和替换规则决定,护栏不按 bash 解析就判断不准:
| 命令 | 会删吗 |
|---|---|
echo "rm -rf /" | 不会,只是字符串 |
grep "rm -rf" log.txt | 不会,是 grep 的参数 |
x=$(rm -rf build) | 会,命令替换里的命令照样执行 |
cat <<'EOF' 正文里写 rm -rf / | 不会,带引号的 heredoc 正文只是文字 |
cat <<EOF 正文里写 $(rm -rf /) | 会,不带引号的 heredoc 会执行替换 |
\rm -rf x、'rm' -rf x、r''m -rf x | 都会,去掉引号后都是 rm |
所以护栏分两层:先按 bash 规则找出真正会执行的程序和它的参数,再按 find、xargs 各自的规则看参数里有没有删除。护栏最早的 bash 解析是手写的,后来换成了 shfmt 背后的 mvdan.cc/sh,它被大量真实脚本检验过;PowerShell 没有现成的 Go 解析器,仍是手写的引号感知分词。Rust 这边有 brush-parser、tree-sitter-bash,成熟度和语义精确度差一截。

把重写的账算清楚
当晚 23:40,负责人让 agent 给一份完整的 Rust 重写计划和时间。先量了体量:Go 源码约 6.4 万行,测试约 9.1 万行。最危险的 core(账本、墓地、下葬、复活、火化、到期收割)源码 1.5 万行、测试 2.1 万行;integrate(obit init,改写各家 agent 的配置)1.2 万和 1.5 万;cli(30 多个命令)0.8 万和 1.5 万;hook(26 种 agent 的接入)0.5 万和 0.9 万。图形界面的前端是 React,官网也不是 Go,这两块不用动。
| 阶段 | 内容 | 时间 |
|---|---|---|
| 0. 验证 | 四道关卡,任何一道不过就停 | 1–2 周 |
| 1. 打地基 | Cargo 工程、测试隔离、三平台 CI、cargo-mutants,以及同一个输入同时跑 Go 版和 Rust 版、比较输出、退出码和账本状态的差分测试 | 1–2 周 |
| 2. 核心 | core 和 winfs,必须能直接读写现有的账本和墓地;2.1 万行测试全部移植,变异测试的杀伤率达到现在的水平 | 3–4 周 |
| 3. 护栏和 hook | bash 和 PowerShell 解析、26 种 agent 适配,用真实命令语料做差分 | 2–3 周 |
| 4. 外围 | obit init、30 多个命令逐字一致的输出、后台进程、托盘、右键菜单;界面从 Wails 迁到 Tauri | 3–4 周 |
| 5. 打包 | 安装包文件名和 checksums.txt 格式不变,重新申请代码签名 | 1 周 |
| 6. 双跑和切换 | Go 版护栏影子运行,两边判断不一致就记下来;先发 2.0 测试版,再发正式版 | 2–4 周 |
合计 13 到 20 周,前提是负责人拍板、agent 统筹审查、四五个 Codex worker 并行;一个人全职手写要 6 到 12 个月。另一个分支单独估的是 14 到 21 周,结论一样。最大的风险在第 0 阶段的第一道关:拿本机所有 Claude 和 Codex 会话记录里的真实命令(有几十万条)加上护栏的主场景表做语料,以 Go 版的判断为准,主场景表要 100% 一致,语料要 99.99% 一致,每一处不一致都要说得清原因。过不了就得自己写 bash 解析器,再加一到两个月。另外三道关是用 windows-rs 在真实 NTFS 上验证按文件 ID 打开、按句柄改名、回收站的 COM 调用、长路径和硬链接;Tauri 能不能承接现在的界面、托盘和通知;Rust 的官方 MCP SDK 是否覆盖用到的全部功能。
收益那一栏写得很短:安装包和内存更小,没有 GC,账本状态机的类型更严。用户能感知到的功能一项也不会多。性能也不是理由,常驻进程空闲时只占 0.03 个核,hook 启动只要几毫秒。负责人看完说:「算了,拒绝rust」。第 0 阶段没有启动。
什么时候会重新算
Rust 的好处是真的,类型更严,没有 GC,调 Win32 和 COM 更顺手。如果从头写一个新项目,它值得认真比较。对讣告来说,重写要付的不是 6.4 万行源码,而是 9.1 万行测试、2000 万次模糊输入、几百个要反复编译的变异体,以及二十多轮审查留下的那些边界条件,要在另一种语言里从头再证明一遍。
重新考虑的条件还是 11 月 8 日写下的那两条:讣告要作为库嵌进别的 Rust 程序,或者碰到只有 Rust 才有、绕不开的能力。真遇到某个对启动时间或内存特别敏感的小组件,更现实的做法是把它单独写成一个 Rust 小程序;估算里还留了另一条退路,如果 Rust 的 bash 解析器不过关,保留一个 Go 写的护栏小程序,其余部分用 Rust。到现在,这两种情况都还没有出现。