全部文章

阅读约 17 分钟第 5 篇

为什么讣告用 Go,而不是 Rust

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

本页内容
  1. 第一晚:推荐 Rust 的那条理由后来没用上
  2. 1.36 万行时:四条约束
  3. 借着追问,把 Go 的工具链用起来
  4. 6.4 万行时:编译速度和 bash 解析器
  5. 把重写的账算清楚
  6. 什么时候会重新算

讣告(命令 obit)给文件设定寿命,到期下葬进可以复活的墓地,主要给 AI agent 用。它的第一版计划推荐用 Rust 写,第一晚我们已经建好了 Cargo.toml 和两个空入口,几分钟后又换成了 Go。之后的十二天里,代码先后涨到 1.36 万行和 6.4 万行,两次有人认真问要不要改成 Rust,两次算完账都留在 Go。

决定这件事的不是语言偏好,而是这类工具的风险落在哪里。一个替 agent 管文件生死、拦危险删除命令的工具,最怕的是认错文件和读错 shell 命令,不是内存出错。守住这两件事靠的是测试,尤其是要反复重新编译的变异测试,所以编译速度和解析库的成熟度,比语言本身的特性分量更重。

终端截图:用 go build -overlay 编译一个变异体,耗时 3.134 秒,产出 26397184 字节的 obit-mutant.exe;随后删除护栏的模糊测试用 24 个 worker 在约 11 秒内执行 572923 次,峰值约每秒 8.3 万次
同一台机器上的真实输出:编译一个变异体并链接成 26 MB 的开发版程序用了 3.1 秒;删除护栏的模糊测试约 11 秒执行了 57 万多次。

第一晚:推荐 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 毫秒
Stop0.5 毫秒127 毫秒
删除护栏 PreToolUse0.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,成熟度和语义精确度差一截。

终端截图:sed 打印 go.mod 第 7 到 23 行的 require 块,直接依赖里有 github.com/modelcontextprotocol/go-sdk、github.com/spf13/cobra、github.com/wailsapp/wails/v2、golang.org/x/sys,最后一行是 mvdan.cc/sh/v3
go.mod 里的直接依赖:MCP 用官方的 Go SDK,bash 解析用 shfmt 的 mvdan.cc/sh,系统调用走 golang.org/x/sys。

把重写的账算清楚 ​

当晚 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. 护栏和 hookbash 和 PowerShell 解析、26 种 agent 适配,用真实命令语料做差分2–3 周
4. 外围obit init、30 多个命令逐字一致的输出、后台进程、托盘、右键菜单;界面从 Wails 迁到 Tauri3–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。到现在,这两种情况都还没有出现。

全部文章