代码仓库里的蟑螂屋现象及瘦身三件套

上周五深夜，当我第3次在三个不同文件里看到那个叫validateUserCredential的函数时，终于忍无可忍摔了键盘——这种重复造轮子的代码就像衣柜里永远配不成对的袜子，每次维护都让人抓狂。

一、代码仓库里的“蟑螂屋”现象

我的MacBook储存空间报警那天，在~/projects/old_versions里发现了23个废弃的docker-compose.yml。这场景让我想起合租室友塞满过期泡面的储物柜，那些你以为“可能有用”的东西，最终只会成为技术债的温床。

1.1 重复代码的三大重灾区

• 工具类函数：每个新来的junior都觉得自己能写出更好的日期格式化工具
• 配置文件：feature开关、环境变量、测试用例参数像野草般疯长
• UI组件：某次代码评审发现4个不同版本的loading动画

二、我的代码瘦身三件套

经过三年踩坑，我总结出这套组合拳，曾在电商项目里帮团队删掉19%的冗余代码。

2.1 嗅觉训练：识别代码异味

打开IDE时，我会像厨房小白辨认变质食材那样扫描这些信号：

• 超过6个月未改动的utils目录
• 被注释掉的代码块（那些//TODO: remove later永远没人处理）
• 单元测试覆盖率低于40%的模块

2.2 精准手术：AST分析实战

最近用GoAST解析器抓到一个典型案例：三个业务模块各自实现了几乎相同的JWT校验逻辑。合并后构建时间缩短了28秒，效果堪比给CI/CD管道通了次下水道。

// Beforefunc checkToken1 bool { / 58行 / }func verifyToken bool { / 62行 / }// Afterfunc validateJWT bool { / 统一实现 / }

2.3 版本控制的时空管理

在Git仓库里执行BFG Repo-Cleaner时，发现某次Hackathon残留的2.7GB视频素材。建议每月执行一次：

• git filter-branch清理历史大文件
• git gc --aggressive压缩仓库
• git archive生成纯净快照

三、那些让我栽过跟头的坑

去年误删某个legacy.js导致生产事故后，我现在每次清理都遵循这三个原则：

四、持续保洁的自动化方案

我现在团队推行的代码卫生日机制，配合GitHub Action实现自动化巡检：

• 每周一自动生成重复代码报告
• 每月15日触发依赖项过时检测
• 每次MR自动检查新增文件数

窗外的咖啡机发出完成提示音，屏幕上的SonarQube报告显示代码重复率已降至4.2%。保存、提交、推送，今天的代码大扫除暂告段落——虽然知道明天又会有新的冗余悄悄滋生，但至少今晚能睡个安稳觉了。