用途:在把一个单体源文件拆分为多个小模块之后,用该技能完成收尾清理,且不改变运行时行为。
主要能力与步骤:
- 归档原单体文件:删除前先复制或移动到 src/_archive/,并加 .bak 后缀,例如 src/_archive/foo.rs.bak;替换模块就位后再从 src/ 删除原文件。
- 避免重复模块路径:不要同时保留 foo.rs 与 foo/mod.rs,每个模块只保留一种路径策略。
- 保持公共 API 稳定:必要时通过 mod.rs(或等价索引文件)重新导出。
清理清单:移除拆分过程中引入的未使用导入;确认 mod.rs 或索引文件重新导出了所有预期公共项;更新 lib.rs 或父模块声明指向新模块路径;确认原单体文件只剩归档的 .bak;对重构模块运行快速构建或针对性测试。
范围限制:除非明确要求,不改变运行时行为;清理聚焦于模块路径一致性与 API 连续性;避免借清理之机进行大范围重构。
适用场景:Rust 等使用 mod.rs 模块路径约定的项目在完成单体文件拆分后的收尾阶段。具体支持语言与工具链细节资料未提供。