单包 Rust 项目迁 Cargo Workspace:先拆边界再移动依赖
把多个 crate 收进 Workspace 时,我会先迁一个依赖最少的公共包,并让它在新旧入口都能通过 cargo check。确认依赖版本、特性和发布方式没有变化,再动上层 crate。
每一步单独提交并保留回退点,比在一个分支里改完所有 Cargo.toml 更容易定位问题。Workspace 能统一依赖,并不会自动解决循环依赖或特性冲突;迁移前仍要把依赖图画清楚。
第一步只在根目录增加 [workspace] 和成员列表,确认原包仍能构建。随后把可复用代码移动到 library crate,让二进制 crate 只保留参数解析和组装。依赖放在真正使用它的 crate 中;只有版本需要统一时,再考虑 workspace 级依赖声明。
每次移动后运行 cargo check --workspace 和 cargo test --workspace,再检查 cargo tree 是否出现重复版本或意外启用的 feature。若某个 crate 需要单独发布,还要核对包名、路径依赖和版本字段,不能只验证 Workspace 内部能编译。
目录可以先保持简单:根目录只放 Workspace 配置,crates/core 保存业务库,crates/cli 负责命令行入口。若两个 crate 相互引用,先找出共同的数据类型或 trait,提到更底层的库;不要通过再建一个“大杂烩 common”掩盖循环依赖。
迁移依赖时也要看 feature。Workspace 统一版本不等于所有成员都应启用同一组 feature,尤其是 TLS、数据库驱动和异步运行时。用 cargo tree -e features 查看最终启用结果,确认 CLI 没被无意带入服务器专用依赖。
旧入口下线前,我会从仓库根目录和各成员目录分别执行常用命令,确认 README、CI 和发布脚本的工作目录假设都已更新。编译通过但自动化脚本仍指向旧路径,也算迁移没有完成。
330



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



