检查旧项目的残留依赖,不能只看代码里还有没有旧函数名,而要从交付结果倒推:这次交付要删掉什么、保留什么、谁来确认、拿什么验收。对“百度快照更新慢”这类历史概念相关项目,残留依赖往往不是程序包,而是旧文档、旧链接、旧配置、旧流程和旧责任人。检查的目标是让接手的人能清楚判断哪些内容已失效、哪些仍需维护、哪些可以直接移除。
多人协作时,返工通常来自“以为已经清理干净”。先写清楚本次交付要产出什么,例如:一份可执行的清理记录、一份保留项说明、一份责任人确认表。然后按四类找残留:
这四类里,百度快照更新慢属于历史概念,不应写成今天仍可用的查询入口。检查时只把它当作旧项目中的历史描述对象:如果文档里还在写“等快照更新后即可看到”,就要标记为待确认或待替换,而不是断言某个入口现在还能用。
下面是一组可以直接执行的检查动作。假设项目是一个内部文档站,旧版本里提到过百度快照,现在要清理旧依赖:
如果搜索结果里出现 <h2> 这类作为示例的文字标签,不要把它当成真实页面结构去改。技术示例中的标签只用于说明,不参与实际渲染。
旧项目残留依赖之所以难清,常见现象是“多人各改一部分,最后没人知道全貌”。这时不要断言唯一原因。可能原因包括:
已经定位的原因则不同:例如某条旧链接在三个文件中重复出现,且三个文件都标注了同一旧路径。这是可核对的定位结果。检查时要分开写“可能原因”和“已经定位的原因”,避免把猜测当成结论。
要减少返工,交付资料至少包括:残留清单、判断依据、责任人、验收人、验收结果。判断依据可以是一段旧描述、一个旧链接、一条旧配置,但不能是“我觉得应该删”。适用条件是:项目仍在维护,且多人会继续修改同一批文件。如果项目已经冻结、不再更新,残留检查可以只做记录,不必强制清理。
验收时用三个检查项判断结果:第一,清单中每条记录都有明确状态;第二,待确认项都有下一步动作和负责人;第三,删除或替换项已由非操作人确认。三项都满足,才算交付清楚。任何一项缺失,都可能让后来的人重新翻查旧项目。
下一步,选一个你正在协作的旧项目,按上面的四类残留列一张清单,先只做标注,不改文件。标注完成后,再约验收人逐条确认,把待确认项转成明确结论。