Aider 是终端里的 AI 结对编程工具:在项目目录里启动它,用聊天的方式让它改代码——它直接编辑文件、能配合你的编辑器、还能自动跑检查与测试来验证自己的改动。Apache-2.0 许可证,GitHub 实时 50,160 星(本站核对:2026-11-18),PyPI 包 aider-chat 最新版 0.86.2(注册表核对)。本文步骤以官方 README 与文档为准,本站未实机运行。
能干什么
- 在终端里结对:cd 进项目、启动、把需求说给它,它直接在真实文件上动手,不是给你一段代码让你自己贴。
- 在编辑器里使唤它:官方有 watch 用法——在代码里写注释下指令,它盯着文件改,你不用离开 IDE。
- 能看图和网页:把截图、参考图、文档网页链接加进对话当上下文,适合照着设计稿或报错截图干活。
- 能开口说:支持语音转代码,对着它说需求也能改。
- 改完自检:可配置成每次改动后自动跑 lint 与测试,发现问题它自己修——这是它和「只出主意」型工具的分界线。
- 不绑模型:README 的上手示例直接给了 DeepSeek 等多家模型的接法,也能通过网页聊天复制粘贴的方式配合任何模型的网页版用。
优缺点
优点:老牌、专注、轻——不换编辑器、不搬工作流,终端里多开一个窗口就开始;模型自选且示例对国内用户友好(官方示例就带 DeepSeek);改动自带检查闭环,适合小步快跑的维护型工作。
缺点与边界:纯终端形态,没有图形界面,第一次用要适应聊天式改代码的节奏;它擅长的是「围着现有代码改」,从零起大项目时,项目结构与规矩要人先立好;上下文要靠你喂对文件,喂错范围它就改偏。
下载与安装(官方 README 口径)
- 用官方安装器:
python -m pip install aider-install,再运行aider-install完成安装。 - 进入你的项目目录:
cd /to/your/project。 - 带模型与密钥启动(README 原例,DeepSeek):
aider --model deepseek --api-key deepseek=<key>。换其他模型同理,按官方文档的模型列表选名、配对应密钥。 - 验证:先让它做一个无风险小改(例如给某个函数补一句注释),看它是否改对文件、diff 是否干净。
调用与使用
- 先把文件喂对:开工先把要改的文件加进会话,范围越准,改得越对;无关文件别一股脑全塞。
- 需求说结果:「把登录失败的提示改成中文并加上重试按钮」,比「改一下登录」返工少得多。
- 打开自检:按官方文档把 lint 与测试命令配上,让它每次改完自动跑,红了自己修,你只看最终状态。
- 在 IDE 里用 watch:不想切终端时,在代码注释里写指令让它动手,具体写法看官方 watch 文档。
- 勤提交:每完成一个小改动就提交一次版本,改坏了能一键回到上一个好状态——这也是和它配合的基本纪律。
调教成自己的
- 把项目约定(命名、目录、禁用写法)写成一份说明文件,开工时先让它读。
- 模型按任务换:小改用便宜模型,复杂逻辑再切强模型,启动参数里改 –model 即可。
- 常用指令存成自己的清单:补测试、加注释、改报错信息这类高频活,话术固定下来。
玩法:小项目维护者的「清积压之夜」
模拟一位维护着两三个小工具站的站长:平时没空,卡点是小毛病越攒越多——报错提示不友好、依赖该升级、注释缺失。他的打法:
- 每周留一晚,把积压小毛病列成清单,按「有明确对错」排序:能被测试或 lint 判定的排前面。
- 开 Aider 并配好自检,让它逐条改:改一条、跑一遍检查、提交一次。
- 人只做两件事:喂对文件、看最终 diff。拿不准的条目当场跳过,不让它硬猜。
- 一晚清掉的条数记下来——这个数字就是下次要不要继续用这个流程的依据。
避坑指南
- 密钥别写进仓库:启动参数里的密钥不要存进项目文件或脚本提交上去,用环境变量或本地配置。
- 没有版本管理别开工:先让项目处于 git 管理下再让它改,这是回滚的底线(它与 git 工作流的配合方式见官方文档)。
- 一次只给一个任务:多个不相干的改动混在一个会话里,diff 会乱成一团,谁也审不了。
- 自检没配等于白改一半:lint/测试命令花十分钟配好,后面每个任务都受益。
档案
- 仓库:github.com/Aider-AI/aider;许可证 Apache-2.0;文档 aider.chat/docs。
- 星数 50,160(2026-11-18 实时核对);PyPI 包 aider-chat 最新版 0.86.2(注册表核对)。
- 本站验证:README 功能与安装口径、PyPI 元数据已核;未实机运行,步骤以官方文档为准。
常见问题
它和 OpenCode 怎么选?两者都是终端结对:OpenCode 是带 plan/build 双模式的智能体平台,Aider 更老牌专注、围绕聊天改代码+自检闭环。先看你更在意「先出计划」还是「改完自检」。
国内模型能接吗?能,官方上手示例直接给了 DeepSeek 的接法,其他国产模型按官方模型文档配置。
不会用终端怎么办?它有编辑器 watch 用法可以少敲命令;完全不想碰终端的,先看 Cline 这类编辑器内工具(本站同系列有篇)。
站内往下读:AI智能体栏目、OpenCode 教程、AI编程栏目。



