作者：阿里云云效团队
一个常见的翻车场景
改了一个公共函数的返回值类型，自测没问题，评审也过了。三天后另一个团队反馈线上报错——他们的模块调用了这个函数，没有同步更新。
类似的事情还有：重构了事件系统的 API，逻辑上没毛病，但下游四个服务的调用方式全部失效，数据丢了一批才发现。
这类问题的共同特征是：改动本身没问题，问题出在改动和其他代码之间的关系上。尤其是 Python、JavaScript 这类弱类型语言，编译阶段拦不住，只能等到测试甚至线上才暴露。
而传统的代码评审——包括早期的 AI 评审——只看你本次提交的 Diff。改动影响了哪些调用方、上下游有没有同步适配，它看不到。
这次升级做了什么
云效 AI 智能评审新增了跨文件感知能力。简单说就是：AI 评审不再只看 Diff 里的代码，而是会自动追踪你改动涉及的上下游调用关系，把没出现在变更列表里的受影响代码也纳入评审范围。
具体的工作流程是这样的：当你提交代码变更时，AI 先识别你改了哪些函数、类、变量，然后在整个代码库里找到这些符号被谁调用、被谁引用，把相关的代码片段和依赖文件拼成完整的上下文，最后基于这个全局视图来做评审。
三个典型场景
下面是三个真实场景，展示跨文件感知在实际评审中的作用。
场景一：接口参数顺序变更，调用方传参错误
开发者调整了一个 Java 接口的参数顺序，编译正常通过，接口设计看起来也更规范了。传统评审到这里就结束了——Diff 本身没问题。但跨文件感知会继续追踪这个接口的调用方，发现有一处调用仍然按原来的顺序传参，导致 categoryId 被当作 channel 传进去了。编译器不会报错，但运行时逻辑完全错乱。
场景二：方法返回 null 而非空列表，调用方 NPE
开发者把一个方法的返回值从空列表改成了 null，觉得语义更明确。传统评审看改动本身会觉得合理。但跨文件感知检查了所有调用方的代码，发现有两处直接对返回值调用了 .size() 和 .forEach()，一旦返回 null 就会触发 NullPointerException。这种问题在代码库大、调用方多的情况下，人工评审几乎不可能逐个排查。
场景三：方法新增异常，上游未处理
开发者在一个方法里新增了业务校验逻辑并抛出异常。改动本身合情合理，传统评审不会有异议。但这个方法被多个上游服务调用，跨文件感知追踪后发现其中几个调用方没有处理新增的异常类型，一旦触发就会直接返回 500 错误或导致批量任务中断。调用方越分散，这类问题越容易遗漏。
实测效果
在跨文件代码影响专项测试集上验证，跨文件感知上线后，评审召回率从 61% 提升到 80%，提高了 19 个百分点。也就是说，之前有近五分之一的跨文件风险问题会被漏掉，现在能被提前拦截。
这个能力对以下几类场景尤其有效：弱类型语言（Python / JS）的方法签名变更，编译阶段拦不住，现在 AI 在提交时就能检查；调用链复杂的公共函数修改，你改的函数可能被多个团队调用，AI 会自动追踪所有调用方；以及返回值语义变更这类编译器不报错但调用方会崩溃的情况。
如何使用
即日起对所有云效 Codeup 用户限时免费开放。
跨文件感知通过沙箱配置开启。在代码库的评审配置中加上以下内容即可：
reviews: # 沙箱配置（可选） sandbox: enable: true enable_crossfile_analyze: true
两个参数的含义：enable 开启沙箱环境运行 AI 评审，可选 true / false，默认 false；enable_crossfile_analyze 开启跨文件变更检测，可选 true / false，默认 false，需要 enable 为 true 时才生效。开启后，AI 评审会自动识别跨文件的破坏性变更，比如返回值语义变化、未处理异常、参数顺序调整等。
需要注意的是，开启跨文件分析后，评审的 Token 消耗和耗时会有所增加，因为 AI 需要读取和分析更多的关联代码。
欢迎体验并反馈使用感受。
云效 AI 评审帮助文档：
https://help.aliyun.com/zh/yunxiao/user-guide/ai-intelligent-...
详见官网链接：
