接手遗留项目,我先用 AI 做一次代码 Review

举报
yd_293301079 发表于 2026/11/16 21:15:57 2026/11/16
【摘要】 * 没有文档、没有测试、原作者已经离职——这种项目的风险不在"看不懂",在"没看全"。本文记录一次用 AI 代码评审给遗留项目做体检的完整流程:怎么圈定范围、怎么读报告、哪些问题必须先修、修完怎么复验。

摘要:* 没有文档、没有测试、原作者已经离职——这种项目的风险不在"看不懂",在"没看全"。本文记录一次用 AI 代码评审给遗留项目做体检的完整流程:怎么圈定范围、怎么读报告、哪些问题必须先修、修完怎么复验。

一、为什么不是先跑起来

接手一个陌生项目,最常见的动作是先把它跑通:装依赖、改配置、点开首页,看到页面能出来,心里就踏实了一半。

但"能跑通"和"没问题"是两件事。跑得通的代码里,可能藏着拼接的 SQL、写死的密钥、没有边界检查的数组访问。这些不会让程序立刻崩,只会在某个特定输入下爆掉——而那个输入,往往来自线上。

所以我的顺序是反过来的:先静态过一遍,摸清风险分布,再决定要不要动结构。这一步用 AI 代码评审来做,理由很实际——它不困、不烦,几千行代码一次扫完,给出一份按严重程度分级的清单,比人眼翻两天靠谱。

二、四步流程

第一步,圈定范围。

不要一上来就全仓库扫。先按业务链路划分核心模块:登录、支付、数据读写、定时任务。第一轮只扫这几块。

范围小,噪音少,结论能直接用。全仓库扫出来的几百条告警,看着壮观,实际没人处理。

第二步,发起评审。

在码道里打开项目,选中目录后发起一次 Review,让它按安全、性能、可维护性三个维度出报告。目录级评审比单文件评审有用,因为跨文件的调用关系只有放在一起看才成立。

第三步,读报告只看三类。

  • 高危:注入、越权、密钥硬编码、任意文件读写
  • 高频:重复代码、超长函数、深层嵌套
  • 可疑:异常被吞、并发无锁、资源未释放

剩下的先放着。命名不规范、注释缺失这类,记进待办,不要现在动。

第四步,修完立刻复验。

每修完一批就重跑一次评审。这一步不能省——很多时候问题不是被修掉了,是被改到别处去了。

三、一个高危例子

遗留项目里最典型的一类问题,是字符串拼接出来的 SQL:

sql = "SELECT * FROM orders WHERE user_id = " + user_id
cursor.execute(sql)

评审会直接标为注入风险。修法是参数化:

sql = "SELECT * FROM orders WHERE user_id = %s"
cursor.execute(sql, (user_id,))

后者不是"写法更优雅",是"拼不出恶意语句"。输入 user_id = "1 OR 1=1" 时,前者会把整张表交出去,后者只会查不到数据。

这类问题的优先级永远排第一,原因很简单:利用成本极低,一个 URL 参数就够了。

四、哪些问题可以暂时不修

不是所有告警都要当天处理。我的判断标准:

类型 处理时机
高危安全问题 当天修,没有例外
影响正确性的并发问题 本周修
重复代码、超长函数 跟着业务改动顺手清
命名、注释、纯风格 不动

最后一条要说清楚:纯风格问题改了,只会增加 diff 行数,不增加任何安全性。遗留项目最忌讳的就是"顺手大改",改完没人敢 review,风险反而更高。

五、两个坑

坑一:把 AI 的结论当判决。

评审报告是线索,不是结论。它标了"可能存在注入",你要确认这个变量是否真的来自外部输入。有没有可能它来自内部枚举?有可能。误报要自己排掉,别一股脑全改。

坑二:一次修太多。

第一批只修高危,修完复验、提交、再修下一批。一次改三十个文件,出了问题根本定位不到是哪一处引起的。

六、小结

遗留项目的风险不在"看不懂",在"没看全"。AI 评审解决的是覆盖面问题——它替你把每一行都看一遍,但判断还是得自己做。

真正交付给下一个人的,不是"我大概看过了",而是那份分级清单和每一处的处理理由。有了它,下一个人接手时,至少知道哪里埋着雷。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。