对你的AI零信任:为什么我专门给代码垃圾写了个Linter

以零信任姿态对待AI生成的代码
AntiSlop CLI:代码垃圾检测工具

代码过了评审,过了测试,顺利发上了生产。

三周后,我在鉴权流程里翻出了一行 // TODO: implement actual validation 注释。

写出这行代码的哪是初级工程师,分明是个AI助手。

就在那一刻我回过神来:AI制造技术债的速度,早就超过了人工评审能兜住的极限。

偷懒AI留下的面包屑

现在谁都在用AI编程助手。Cursor、Copilot、Agent Mode,个个都是生产力倍增器。

但AI模型的优化目标是"看着像那么回事儿",压根儿不管逻辑有没有真正写完。它们总爱在代码里到处留下面包屑:

模式潜台词危险在哪儿
TODO、FIXME"这段我没写完"当成隐形技术债直接上线
"for now"、"temporary""我知道这么写不对"临时凑合变成永久祖传
todo!()、unimplemented!()能骗过编译器的空桩运行时直接崩溃
"hopefully"、"should work"我也没底这玩意儿能不能跑出了事儿锅归你背

我把这种东西叫作 code slop(代码垃圾)。"能编译通过"和"真正写完了"之间,差的就是这层东西。

AntiSlop 在真实项目中揪出代码垃圾

AntiSlop 专门揪出AI助手留下的半成品痕迹。


为什么 grep 救不了我

最开始我也干了所有人都会干的事:grep -r "TODO" .

结果根本行不通,原因有三点:

  1. 误报:print("TODO: Output metrics") 只是一个普通字符串字面量,跟技术债八竿子打不着,grep 照样报警。
  2. 漏报:raise NotImplementedError 里连个 "TODO" 的影子都没有,但它就是妥妥的半成品代码。
  3. 缺乏上下文:在完整业务逻辑旁边写一句含 "temporary" 的解释性注释,跟拿注释糊弄事儿的空桩函数完全是两码事。

我需要一个真正看得懂代码语法结构的工具,光在纯文本表面扫关键字根本不够看。


Tree-sitter 带来的降维优势

我用 Rust 写了 AntiSlop,速度足够快,塞进 CI/CD 流水线毫无压力。

它彻底抛弃了正则表达式,直接用 Tree-sitter 把代码解析成抽象语法树(AST),然后遍历整棵语法树精准锁定三类目标:

  • 注释节点:自动跳过字符串字面量,只检查真正的注释节点。
  • 结构化空桩:依据各语言的语法规则,直接揪出空函数体或特定占位宏(如 todo!()、pass)。
  • 模棱两可的套话:识别文档和注释里拿不准的含糊措辞(如 "assuming"、"likely")。

AntiSlop CLI 帮助界面展示支持的语言与参数选项


安装方式

AntiSlop 打包成单个独立二进制文件,零配置开箱即用。

预编译二进制包(Linux/macOS)

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/skew202/antislop/releases/latest/download/antislop-installer.sh | sh

Homebrew

brew install skew202/tap/antislop

Windows(PowerShell)

powershell -c "irm https://github.com/skew202/antislop/releases/latest/download/antislop-installer.ps1 | iex"

Cargo(Rust)

cargo install antislop

用于 CI/CD 流水线(输出 JSON 格式):

antislop --json

当你的代码库干干净净时,AntiSlop 会给你明确放行:

AntiSlop 检出零问题:真正的完整交付


"正交 Linter"的设计哲学

AntiSlop 与 ESLint、Clippy 并行运行,扮演一道正交检查关卡。

传统 Linter 负责抓语法错误和代码风格违规;AntiSlop 专门抓半成品与未完成项。

如果传统 Linter 绿灯放行,AntiSlop 却报出 "Sloppy",那就说明你的代码排版工工整整,核心功能却只写了一半。

对AI生成的代码保持零信任。先验明代码确实写完了,再推上生产。


相关链接:


喜欢这篇文章?欢迎订阅我的周刊 SeekingSota,聊透当工程师不再手敲样板代码、转而拿起指挥棒调度AI代理时会发生什么。

平时也爱造轮子?不妨看看 EnvCheck、NerfStatus 或 HCT。

Search stefanwiest.de

Type to search