Aider 快速上手教程（GitHub README 中文整理）

是什么

Aider 是一款运行在终端里的 AI 结对编程工具。它能让你在命令行中直接与大型语言模型（LLM）对话，协助你从零开始写新项目，或者在已有代码库上继续开发。Aider 本身由 AI 辅助编写，其最新版本中 88% 的新代码由它自己生成。

能干什么

• 支持多种 LLM：最佳搭配是 Claude 3.7 Sonnet、DeepSeek R1 & Chat V3、OpenAI o1、o3-mini 和 GPT-4o，也能连接几乎所有其他模型，包括本地模型。
• 代码库地图：自动为你的整个代码库生成地图，帮助 AI 在大型项目中精准定位。
• 100+ 编程语言：支持 Python、JavaScript、Rust、Ruby、Go、C++、PHP、HTML、CSS 等主流语言。
• Git 集成：每次修改后自动生成合理的提交信息，你可以用熟悉的 Git 工具查看差异、管理或撤销 AI 的改动。
• IDE 内使用：在 VS Code、JetBrains 等编辑器中添加注释，Aider 会自动识别并执行修改。
• 图片与网页：在对话中粘贴截图、网页链接，为 AI 提供视觉上下文或参考文档。
• 语音转代码：直接用语音描述需求（新功能、测试用例、Bug 修复），Aider 会帮你实现。
• 自动检查与测试：每次修改后自动运行 lint 和测试，发现问题还能自动修复。
• 复制粘贴到网页对话：方便将代码片段分享到其他 AI 聊天工具。

怎么装

前提条件：确保已安装 Python 3.8 或更高版本，以及 Git。

安装命令（在终端中执行）：

pip install aider-chat

如果你需要语音功能，可以额外安装：

pip install aider-chat[voice]

怎么用第一个例子

1. 设置 API 密钥（以 OpenAI 为例）：

   export OPENAI_API_KEY=你的密钥
   

2. 启动 Aider，并告诉它你要处理的代码目录：

   aider /path/to/your/project
   

   如果只想在当前目录工作，直接运行 aider 即可。

3. 开始对话：在终端里输入自然语言指令，例如：

   > 帮我给这个 Python 脚本添加一个命令行参数，支持 --verbose 选项
   

   Aider 会分析代码、做出修改，并自动生成 Git 提交。

4. 查看结果：修改完成后，用 git diff 或 git log 查看改动历史。如果对结果不满意，可以用 git reset 回退。

小提示：首次使用建议先在一个测试项目上试试，熟悉后再应用到正式项目。

社区资源

• 官方文档：https://aider.chat/docs/（包含 LLM 配置、语言支持、Git 集成等详细说明）
• GitHub 仓库：https://github.com/Aider-AI/aider（提 Issue、看源码、参与贡献）
• 排行榜：Aider 在 OpenRouter 平台的应用排名中位列 Top 20。

翻译整理自 GitHub README，原文：https://github.com/Aider-AI/aider