现象改一个字符等三分钟我们有一个 Rust 桌面端项目主 crate 膨胀到了三万五千行。日常开发里最消耗心智的不是写代码是等编译改一行、等 164 秒、跑测试再等一轮。一天改二十次光编译就吃掉一个多小时而且这个等待完全打断心流——你没法在编译间隙思考只能干等。团队一直知道该拆模块了但一直没动手因为直觉里这是个大手术依赖关系盘根错节拆错一处就是一整天的修复。直到某次连续三轮改一行等三分钟的调试之后我们决定把这件事当成正式工程任务来做。## 分析编译粒度是 crate不是文件动手前先搞清楚 Rust 的增量编译单元。Rust 的编译缓存以 crate 为粒度同一个 crate 里任何一行代码变化整个 crate 都要重编而 crate 之间的依赖只要接口没变下游就命中缓存。这就是问题的结构三万五千行一个包意味着改任何一行哪怕一个注释编译器都要把三万五千行全部重来一遍。164 秒里真正和你改动相关的部分可能只有几秒其余全是为粒度太大交的税。再看代码的内容构成这个巨型 crate 里其实住着两类东西。一类是纯逻辑核——解析、判据、纯函数计算不碰系统调用不碰界面输入输出都是数据另一类是外壳——系统 API 调用、窗口操作、界面状态。两类东西搅在一起外壳的平台依赖把纯逻辑也拖进了一动全动的编译单元。## 修法拆出纯逻辑核接口零改动方案把纯逻辑部分整体抽成一个新的独立 crate比如叫 core外壳 crate 依赖它。操作上有三个关键决定。整块搬不重新组织。搬移时保持文件和代码原样不做任何顺手重构。手术台上不做美化是控制风险的基本纪律。用 pub use 做零成本重导出。外壳 crate 里加一行pub use core::*;把核心的所有公开符号原样再导出。这一步的价值在于全项目四十多个调用点一行都不用改——它们 import 的路径没变只是背后多了一层转发。拆库最常见的阻力就是要改遍全项目的 use 语句重导出把这个成本降到了零。测试跟着走外壳加防回归。纯逻辑的测试跟着代码进了 core crate跑起来飞快外壳这边补了两个防回归检查出包流水线原来只跑外壳 crate 的测试要加上 core 的测试门还有一个扫描源代码里内嵌的资源字符串的脚本原来只扫外壳目录扩展成双目录扫描防止拆分后有个角落漏扫。## 效果48 倍以及意外的副产品拆分后实测改一行纯逻辑代码core 重编译 3.4 秒原 164 秒48 倍外壳因为接口没动直接命中缓存。日常调试从等三分钟变成秒级反馈这个体验差异大到难以形容——不是快了 48 倍的爽感而是敢于频繁改代码的心理变化。副产品有两个。其一测试提速纯逻辑的测试不再背着外壳的平台依赖跑CI 时间大幅缩短而且测试可以在无窗口环境跑以前部分测试依赖系统 API只能特定环境跑。其二架构上被迫划清了纯逻辑与外壳的边界——这条边界线后来成了代码评审的准绳新功能先问这属于核还是壳核里不许出现系统调用。## 泛化编译时间是一个架构信号最后说一个视角转换编译时间不只是等待它是架构耦合度的信号灯。一个 crate 编译慢通常意味着它承担了太多不相干的职责拆分的收益也远不止省时间——被迫划出的边界往往就是架构本来该有的形状。如果你的项目也存在改一行等几分钟先做个归因缓存粒度问题拆还是真依赖问题断依赖。多数巨型 crate 是前者而且拆的手术比想象中小——前提是克制住顺手重构的冲动。## 边界怎么划顺着数据流找纯逻辑拆分计划里最不确定的一步是划线哪些代码属于核哪些属于壳。我们用的办法是顺着数据流找。从项目里最纯的那些函数出发——判据计算、文本解析、状态转换——把它们的依赖闭包拉出来看。判断标准只有一句话这个闭包里是否出现系统世界。文件、网络、窗口句柄、注册表、线程、时钟只要闭包里出现其中任何一个就出核纯数据进纯数据出的留核。时钟也算依赖凡是拿当前时间做判据的地方把时间改成参数由调用方传入核里不感知现实时间。划线的过程会发现一些意外的藕断丝连某个看似纯的解析函数里埋着一处日志写文件某个判据函数里藏着一次系统调用。这些都要在拆分时理顺——日志改成返回值带出系统调用挪到外壳。拆库的隐性收益就在这里它强迫你审视每一处隐式依赖。拆完之后要守门。核目录里禁止引入系统调用这条约定写进评审清单任何想把系统依赖塞回核里的改动都会被拦下。边界划出来只是开始守住边界才是长期工程。对工作流的改变是渐进但深刻的。改-测循环进入秒级之后先写测试再写实现才头一次真正可行——在此之前不是不想是每次跑测试三分钟的摩擦让人自动放弃。工具的延迟决定了开发习惯这大概是这次重构最意外的收获。拆分过程还顺带修了两个流水线漏洞都是拆分暴露出来的。出包流水线原来只跑外壳 crate 的测试拆出核之后核的测试不在出包门禁里——头一次出包含核改动的包时差点漏测补上了核测试门禁。另一个是资源字符串扫描器原来只扫外壳目录拆分后核目录成了扫描盲区扩展成双目录扫描并加了反向自证。这两个洞的价值在于提醒任何流水线都隐含着目录结构假设结构一变假设就碎。改结构的时候把流水线配置翻出来对一遍应该成为发布清单的固定条目。## 参考文章-微信自动回复软件哪个好5 类工具对比与避坑清单2026- 微信 AI 客服机器人多少钱一个月2026 价格与效果详解