Aider 代码 Lint 与自动修复机制解析用 tree-sitter 把 Lint 错误转成 LLM 能看懂的修复指令【免费下载链接】aideraider is AI pair programming in your terminal项目地址: https://gitcode.com/GitHub_Trending/ai/aiderAider 在每次应用 LLM 的编辑之后都会对改动的文件做 Lint 检查发现错误时可自动把「带代码上下文」的错误报告回传给 LLM 迭代修复此外也能通过/lint命令或--lint命令行开关随时对仓库中的文件做按需 Lint 与修复。读完本篇你将掌握 aider 的 Lint-修复闭环如何工作、为什么它要用 tree-sitter 增强 Lint 报告、以及如何用--lint-cmd和.aider.conf.yml接入团队自己的 Linter。Lint 与修复的两种触发方式aider 的 Lint 能力有两类入口分别对应「编辑后自动检查」和「随时按需检查」。1. 编辑后自动 Lint默认开启每次 LLM 建议的编辑被应用到代码库之后aider 会对所有被编辑的文件运行 Lint。若在 Lint 中发现问题aider 会询问你是否希望它尝试修复确认后会向 LLM 发送 Lint 错误报告并请求修改该过程可能迭代若干次直到所有问题被彻底解决或迭代结束。从源码看这条调用链位于 BaseCoder.run_oneif edited and self.auto_lint: lint_errors self.lint_edited(edited) self.auto_commit(edited, contextRan the linter) self.lint_outcome not lint_errors if lint_errors: ok self.io.confirm_ask(Attempt to fix lint errors?) if ok: self.reflected_message lint_errors return几个值得注意的实现细节auto_lint由命令行参数--auto-lint控制BooleanOptionalAction默认True可用--no-auto-lint关闭参数定义见 args.pyLint 错误被赋给self.reflected_message后直接返回——下一轮对话会把这段错误报告作为「反思消息」重新发给 LLM由 LLM 自己产出修复编辑这就是所谓「迭代修复」的底层机制Lint 完成前后各做一次自动提交第二次提交带contextRan the linter保证每轮编辑与 Lint 状态在 git 历史中可追溯lint_outcome记录了 Lint 是否通过供后续流程如测试反馈使用。lint_edited的实现在 base_coder.py它对每个被编辑文件调用self.linter.lint(...)把各文件的错误报告拼接后既打印给用户tool_warning又返回给上层用于回传 LLM。2. 按需 Lint/lint命令与--lint参数聊天中的/lint命令默认 Lint 并修复已加入聊天的全部文件也可以指定 git 仓库中的任意文件作为参数。命令行aider --lint会 Lint 并修复仓库中所有 dirty未提交改动文件也可以在命令行直接指定文件名。Commands.cmd_lint 展示了/lint的完整行为未指定文件时先取聊天文件仍没有则回退到self.coder.repo.get_dirty_files()对每个有错误的文件打印报告并询问Fix lint errors in {fname}?开始修复前若仓库还有其他脏改动会先执行一次 commit然后克隆出一个清空聊天历史的临时 codercur_messages[], fnamesNone加入目标文件并把错误报告作为输入run(errors)驱动修复。命令行入口则在 main.pyargs.lint为真时直接调用coder.commands.cmd_lint(fnamesfnames)随后自动 commit 并退出——这使得aider --lint file.py可以作为一次性脚本化用法。相关的命令行开关定义见 args.py参数默认值说明--lintFalseLint 并修复指定文件未指定文件时处理 dirty 文件--lint-cmd[]指定按语言执行的 lint 命令可多次使用--auto-lint/--no-auto-lintTrue编辑后是否自动 Lint对应的环境变量与配置文件写法分别记录在 docs/config/options.mdAIDER_LINT、AIDER_LINT_CMD和 docs/config/aider_conf.mdlint、lint-cmd键支持列表形式写多个值。面向 LLM 的 Lint 报告格式大多数 Lint 工具的原始输出简短而晦涩例如 Python 的 flake8app.py:23:36: F821 undefined name num app.py:41:16: F541 f-string is missing placeholders这种输出依赖使用者自己查行号定位错误而 LLM 并不擅长基于行号操作代码——即使给它带完整行号的代码列表也常出现 off-by-one 等错误。aider 的做法是用 tree-sitter 拿到代码 AST把每条错误所在的行在其所属函数、方法、类内部高亮展示为 LLM 提供充分的局部上下文。aider 实际输出的报告形如app.py:23:36: F821 undefined name num app.py:41:16: F541 f-string is missing placeholders app.py: ...⋮... 6│class LongNum: 7│ def __init__(self, num): 8│ 9│ Initialize the number. 10│ ...⋮... 19│ def __str__(self): 20│ 21│ Render the number as a string. 22│ 23█ return str(num) 24│ 25│ 26│app.route(/subtract/int:x/int:y) ...⋮... 38│app.route(/divide/int:x/int:y) 39│def divide(x, y): 40│ if y 0: 41█ return fError: Cannot divide by zero 42│ else: 43│ result x / y 44│ return str(result) 45│ ...⋮...注意错误行前的█标记和...⋮...省略号代码按 AST 结构折叠到相关作用域错误行被明确标出LLM 看到的是「哪段逻辑里的哪一行有问题」而不是裸行号。这段格式由 linter.py 中两个函数共同产出traverse_tree递归遍历 tree-sitter 语法树收集所有node.type ERROR or node.is_missing节点的起始行号——即语法错误行清单tree_context基于grep_ast包的TreeContext生成上述展示关键参数mark_loisTrue用█标记错误行、loi_pad3错误行上下文外扩 3 行、line_numberTrue其输出固定以## See relevant line{s} below marked with █.开头。最终拼装发生在 Linter.lintres # Fix any errors below, if possible.\n\n res lintres.text # linter 原始输出如 flake8 行 res \n res tree_context(rel_fname, code, lintres.lines) # 带 █ 的 AST 上下文也就是说回传给 LLM 的内容 祈使句指令 原始 Lint 输出 带标记的代码上下文。对于外部 linter 的输出errors_to_lint_result 会用 find_filenames_and_linenums 的正则filename:\d从文本中解析出错行号再交给tree_context定位上下文——这就是为什么即使外部 linter 只输出app.py:23:36: ...这种行号式报告aider 也能还原出函数级上下文。内置基础 Linter零配置支持主流语言aider 内置了基于 tree-sitter 的基础 Linter无需用户手动安装或配置即可覆盖主流编程语言支持语言清单见 docs/languages.md。其原理是用 tree-sitter 解析每个文件的 AST遇到语法错误等致命问题时tree-sitter 会插入类型为ERROR的 AST 节点aider 直接利用这些ERROR节点定位所有存在语法或致命错误的行以上文所述的 LLM 友好格式展示。对应实现即 basic_lint根据文件扩展名取语言filename_to_lang调用get_parser(lang)解析再traverse_tree收集错误行。一个显式的边界处理值得留意源码中注释了 tree-sitter 的 typescript linter 尚无法正常工作issue #1132basic_lint对typescript直接返回。Python 有额外的特殊待遇。Linter 构造函数 中内置了pythonself.py_lint这一个语言专属 linterpy_lint 会把三种检查结果合并basic_linttree-sitter 语法错误同上lint_python_compile对代码执行compile()捕获编译期异常并用 traceback 定位出错行区间flake8_lint运行flake8 --selectE9,F821,F823,F831,F406,F407,F701,F702,F704,F706 --show-source --isolated file只挑选致命/近乎致命的错误码--isolated保证不读取用户项目的 flake8 配置。三者任一报错就会合并成单个LintResult返回因此 Python 文件即使语法正确出现未定义名F821这类「运行必炸」的问题也会被自动 Lint 捕获并反馈给 LLM。此外Linter还带一个 main 入口可以直接python -m aider.linter file1 file2 ...的方式对任意文件跑一遍 Lint 并打印报告便于调试。配置你偏好的 Linter--lint-cmd除了内置 Linter你还可以让 aider 使用团队自己的 Linter从而覆盖更大范围的问题风格一致性、更多错误类别等。开关是--lint-cmd# 用 jslint 检查 JavaScript aider --lint-cmd javascript:jslint # 用 flake8 加特定参数检查 Python aider --lint-cmd python:flake8 --selectE9,F821,F823...多条--lint-cmd可以同时指定不同语言的 linter也可以持久化写入.aider.conf.yml配置键lint-cmd写法见 docs/config/aider_conf.md 的注释示例lint-cmd: xxx或列表形式多值。解析逻辑在 parse_lint_cmds符合^[a-z]:.*形式的参数被拆成lang: cmd其中语言名取冒号前、命令取冒号后因此命令内可以合法包含空格与更多冒号不带语言前缀的写法则该命令对所有语言生效存入Linter.all_lint_cmd格式错误时 aider 会报错提示正确格式language: cmd --args ...并以退出码 1 终止。分发规则在 Linter.lint 中优先用--lint-cmd显式指定的命令先查全局命令all_lint_cmd再查按语言的languages表都没有才回退到basic_lint。外部命令的执行路径是 run_cmd用oslex.quote安全引用文件路径后子进程执行返回码为 0 视为无错误非 0 时把## Running: {cmd}和全部 stdout 组装为错误文本再交给errors_to_lint_result解析行号、补上 tree-sitter 上下文。另外从源码结构看配置过的 lint 命令还会进入发给模型的 background/platform 信息base_coder.py 中会提示模型「用户偏好这些 lint 命令」让 LLM 在写代码时就倾向于遵守团队的 lint 规则。验证与测试Linter 的核心行为有对应单测覆盖见 tests/basic/test_linter.pytest_set_linter验证set_linter(javascript, eslint)后语言表被正确更新test_run_cmd/test_run_cmd_with_errors验证返回码 0 时不产生 Lint 结果、返回码非 0 时错误文本被捕获进LintResult.texttest_run_cmd_with_special_chars验证带括号、方括号等特殊字符的路径如src/(main)/product/[id]/page.tsx能被正确引用后传给 linter 命令。小结aider 的 Lint-修复闭环可以归纳为一条流水线编辑应用 →lint_edited逐文件检查内置 tree-sitter 基础 Linter / Python 专属编译flake8 / 用户自定义--lint-cmd→ 用TreeContext把错误行放大到函数级上下文并用█标记 → 经reflected_message回传 LLM → LLM 产出修复编辑并再次进入该循环。关键源码集中在 aider/linter.pyLinter 类、basic_lint、tree_context、行号解析、aider/coders/base_coder.py自动 Lint 与反思回路、aider/commands.py 即aider/commands.py的cmd_lint按需修复流程以及 aider/main.py 的parse_lint_cmds参数解析。【免费下载链接】aideraider is AI pair programming in your terminal项目地址: https://gitcode.com/GitHub_Trending/ai/aider创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考