用 CI 拦住 AI 生成代码的常见缺陷
文章梳理 React Native 与 TypeScript 项目中 AI 代码的常见问题,包括死代码、类型逃逸、悬空 Promise、Hook 依赖错误与安全遗漏。它建议将对应检查纳入 CI,并以 Knip 检测未使用文件、导出和依赖为例。
AI 深度解读
AI 写代码越来越快,人工审查却很难同步提速。作者给 React Native 和 TypeScript 项目的建议是:把 AI 反复犯的机械错误交给自动检查,让人把时间花在需求、交互和数据设计上。
这套方案覆盖死代码、类型逃逸、异步遗漏、依赖越界、无效测试和数据安全。它的价值在于把「请认真检查」变成可执行的门禁,再把失败结果反馈给 agent。不过,原文给出的是工具组合与实践建议,没有提供团队落地后的对照数据。
先把容易重复的错误变成检查规则
AI 经常为当前提示单独找答案,未必会先寻找项目已有的实现。结果是重构后留下旧组件,新增几个没用上的工具函数,或者出现三份日期格式化逻辑、两套略有区别的 useUser。
作者用 Knip 查未使用的文件、导出和依赖,命令是 npx knip,建议至少每周运行一次。死代码还会进入后续 agent 的上下文,被再次参考、复制甚至「修复」,所以清理它也在减少下一轮生成的干扰。
重复代码则交给 npx jscpd src --min-tokens 50 --threshold 3。其中 --threshold 3 表示重复比例超过 3% 时失败。存量项目可以先以当前水平设定基线,再逐步收紧,不必第一天就消灭所有历史问题。
类型检查需要再往前走一步。作者建议同时启用 strict: true 和 noUncheckedIndexedAccess: true,再约束 any、as unknown as、// @ts-ignore 这些绕过类型系统的写法。否则,类型难题只是被藏起来了。
下面的 ESLint 配置把类型感知检查、悬空 Promise 和 Hook 规则放到一起;作者提醒,应按项目调整,Expo 默认配置可以作为基础:
// eslint.config.js(按项目调整;Expo 默认 ESLint 配置是一个不错的基础)
const tseslint = require('typescript-eslint');
const reactHooks = require('eslint-plugin-react-hooks');
module.exports = tseslint.config(
...tseslint.configs.recommendedTypeChecked,
{
languageOptions: {
parserOptions: { projectService: true, tsconfigRootDir: __dirname },
},
plugins: { 'react-hooks': reactHooks },
rules: {
'@typescript-eslint/no-explicit-any': 'error',
'@typescript-eslint/no-floating-promises': 'error',
'@typescript-eslint/ban-ts-comment': 'error',
'react-hooks/rules-of-hooks': 'error',
'react-hooks/exhaustive-deps': 'error',
},
}
);
要看的是 projectService: true:@typescript-eslint/no-floating-promises 需要类型信息,才能识别未妥善处理的异步调用。recommendedTypeChecked 还带入相关 no-unsafe-* 检查,不能只复制几条规则名。
Hook 依赖也要当成错误处理。漏依赖可能读到旧数据,每次渲染都变化的对象依赖可能触发反复请求。作者要求在 agent 指令里明确禁止用注释关闭 react-hooks/exhaustive-deps,避免 agent 为了通过检查直接消音。
架构和测试,不能只看目录与覆盖率
目录写着 features,并不代表模块边界真的存在。agent 为完成局部任务,可能直接引用其他功能的内部文件,让目录约定逐渐失效。
作者先用 no-restricted-imports 限制 @/features/*/internal/*,要求从 feature 的入口导入。更大的项目可以用 dependency-cruiser 表达「feature 不能互相引用」「screen 不能直接访问数据层」等规则,再用 npx madge --circular --extensions ts,tsx src 检查循环依赖。
这里要先由团队决定边界,再由工具执行。工具不会判断项目究竟该怎样分层。
测试也有类似问题。覆盖率高,只能说明代码被执行过,不能证明断言能发现业务损坏。比如只检查登录函数被调用,没有检查登录失败后用户是否看到错误提示,测试可能一直绿着,功能却已经坏了。
作者推荐 npx stryker run 做变异测试:主动翻转条件、删除语句,再观察有没有测试失败。如果代码被改坏仍无人察觉,就要回头检查断言。
覆盖率回答代码有没有被跑过,变异测试进一步追问测试能不能发现错误。
但变异测试较慢。原文建议只覆盖认证、支付、数据访问等关键模块,并定时运行,不要塞进每次提交。
依赖、密钥和数据库,需要各自的门禁
新增依赖不能只看安装是否成功。作者列出的风险包括:为几行函数引入一个包,在 React Native 中选了只适合 Web 的库,以及推荐根本不存在的包名。攻击者注册常被模型编造的包名,也会带来供应链风险。
因此,每次 PR 中的 package.json 变化都应人工审查,安装前检查包是否存在,以及下载量、维护者和仓库情况。Expo 项目再运行 npx expo install --check,检查原生包版本是否匹配 SDK;没用上的依赖继续由 Knip 查。
密钥要另设检查。EXPO_PUBLIC_ 变量会被打进应用,不能承载服务端秘密。作者建议在 CI 和 pre-commit hook 中运行 gitleaks detect --source .,再加自定义规则,拒绝名称含 SERVICE_ROLE 或 SECRET 的 EXPO_PUBLIC_ 变量。
Supabase 项目还有数据库这一关。anon key 随应用分发,数据访问保护依赖行级安全规则(RLS)。agent 可能建表后忘记启用 RLS,也可能为了消除报错,把策略放宽到 using (true)。
下面的查询用于寻找 public schema 中未开启 RLS 的表:
-- 暴露的 schema 中未开启 RLS 的表:应返回零行
select tablename from pg_tables
where schemaname = 'public' and rowsecurity = false;
要看的是 rowsecurity = false。作者建议在 CI 中用迁移文件构建本地数据库后执行,并搜索新增迁移里的 using (true);Supabase 的 Security Advisor 也能提示常见问题。
接入方式可以沿用原文的 GitHub Actions 示例:在 pull_request 时运行,使用 ubuntu-latest、actions/checkout@v4、actions/setup-node@v4 和 Node 20,先执行 npm ci,再运行 npx tsc --noEmit、npx eslint .、Knip、jscpd、madge、Expo 检查及 npm test。密钥扫描与数据库检查放到独立 job,变异测试定时执行。
不要一次全开。先处理类型、悬空 Promise、密钥等高优先级问题,清完存量,再增加下一道门禁。
我的判断
我赞成把重复错误变成可执行规则。尤其在 AI 编程里,只写一句「遵守项目规范」缺少反馈,检查失败则能给 agent 一个明确的修复目标。
但原文没有给出误报率、耗时、缺陷减少比例,也没展示他们团队实施前后的结果。包括人工与 agent 每小时产出量的比较,都缺少测量过程,应视为作者的经验判断。
几处边界也不能混淆:禁止显式 any 不等于已经禁止所有双重断言;Hook 依赖检查通过,不等于副作用设计正确;禁止某一种导入路径,也不等于完整覆盖架构边界。
安全检查同样如此。查询返回零行,只说明被查范围内没有关闭 RLS 的表,不能证明策略正确。搜索 using (true) 是审查线索,具体权限仍需结合表用途判断。原文也没有说明项目存在其他暴露 schema 时该如何扩展检查。
和单纯增加人工审查相比,这套方案适合处理稳定、可重复判定的问题;和只依赖覆盖率相比,变异测试能提供额外证据。需求是否解决了正确的问题、小屏 Android 的体验是否合理、数据模型能否支撑后续变化,仍需要人判断。
能拿来做什么
- 对现有 React Native 或 TypeScript 项目,先把
npx tsc --noEmit和类型感知 ESLint 接入 PR 检查,优先解决类型逃逸与悬空 Promise,再逐步加入重复代码和架构规则。 - 给日常 AI 编程补上完成条件:agent 汇报任务完成前,必须运行类型检查和 lint,并修复失败项。同类错误出现两次,就把约束写进
CLAUDE.md、AGENTS.md或对应指令文件。 - 把依赖变更作为独立审查点,确认新包确实必要、适合 React Native,并核实来源;Expo 项目同时检查 SDK 版本兼容性。
- 对使用 Supabase 的应用,让新表在同一份迁移中启用 RLS,并验证权限策略;关键认证与数据访问模块再安排定时变异测试,检查测试是否真能发现损坏。