工作区拆分到什么程度才合适
工作区边界需要被写进依赖图
把失败写成能读懂的结果
我会给这类工具再留几条反例:输入为空、外部依赖拒绝、重复执行和中途取消。断言不仅检查 Result,也检查状态是否被提前修改、临时文件是否清理。这样失败时可以直接判断是契约改变,还是某条收尾分支漏掉了。
错误信息也要指向用户能处理的位置。说明哪个参数或文件有问题,保留必要的底层上下文,不把一长串内部调用栈当作提示。可预测的失败路径比“尽量自动修复”更适合小工具。
拆分 crate 或包之前,先列出谁依赖谁、哪些类型是对外契约、测试夹具放在哪里。若两个模块每次改动都要一起发布,拆开后只是多了目录,不会减少耦合。能独立构建、独立测试、独立说明用途,才值得成为工作区成员。
元数据和 CI 也要跟着整理。检查 feature 是否跨包泄漏,示例是否引用了私有实现,公共 API 是否被无意扩大。拆分完成后,外部使用者应该只看到需要看到的入口;内部重构可以继续,但不该把临时模块结构变成长期承诺。
第一次看到别人把 Rust 项目拆成一串 crate,我很容易觉得目录越多越专业。自己照着拆过一次才发现,名字变多不会自动带来清晰边界,反而会多出依赖关系、版本约束和跨 crate 调试成本。Cargo 工作区能让多个相关 crate 共享构建目录、锁文件和部分配置,但它不是把文件夹变漂亮的工具。
先问代码能否独立存在
我会从三个问题判断:它能不能独立测试?会不会被两个以上程序实际使用?它的发布或变更节奏是否和主程序不同?如果大多是否定的,先留在同一个 crate 往往更省心。一个命令行小工具里的参数解析、核心计算和输出格式,最初都可以放在一个库 crate 里,由二进制入口调用;等核心计算真的被另一个工具复用,再抽出来。
[workspace]
members = ["app", "core"]
resolver = "2"
有成员列表不表示 core 一定值得存在。它仍应有自己的测试和明确的公开接口。若只是把原来模块名换成 crate 名、对外没有复用点,维护成本可能大于收益。
用元数据核对依赖关系
拆分前后,我会运行 cargo metadata --no-deps,看成员、包名和路径是不是预期。它不会替我做架构判断,但能发现成员漏掉、路径写错或依赖指向异常。然后分别跑测试,而不是只在根目录跑一次:
cargo metadata --no-deps
cargo test -p core
cargo test -p app
独立 crate 至少应能单独测试。示例程序还可以运行 cargo run -p app -- --help,确认入口仍能找到库代码。项目只有一个可执行程序时,清楚的模块划分加 cargo test 已经够用,不必为了配置文件把它拆成多个包。
拆分后仍要守住公开边界
把代码移进新 crate 不等于完成。真正难的是决定哪些类型该公开。为了让 app 能用就把内部字段和辅助函数都标 pub,原有封装会立刻变薄。更稳的起点是只公开少量构造函数和业务方法,编译报错后再判断调用方是否真需要内部细节。
依赖方向也值得画一下。让 app 依赖 core 很自然;若 core 又依赖回 app,通常说明抽取边界不对。目录数量不是架构质量,能独立测试、复用理由明确、依赖方向读得懂,才是拆分是否值得的依据。
我还会检查依赖版本是否真的需要统一。共享锁文件很方便,但不代表所有成员都该打开同一批依赖特性。一个工具只需基础功能,另一个需要可选功能时,最好把需求写在各自清单里。查看构建时间或依赖树时,才不会把“工作区共享”误解成“所有成员装同样的东西”。
最后我会用一个干净的构建目录重新跑测试,避免旧产物掩盖路径或特性配置的问题。它不是性能基准,只是确认工作区声明在新的环境里也能被 Cargo 正确解析。
876



被折叠的 条评论
为什么被折叠?



