Aider 接入教程

什么是 Aider?

Aider 是一个开源的 AI 结对编程工具，它让你在终端中与 AI 配对编写代码。不同于其他 AI 工具只给出建议，Aider 会直接修改你的代码文件。

📝

直接写代码

AI 直接编辑文件，不是只给建议

🔀

Git 集成

自动创建 commit，完整的版本控制

📂

项目感知

读取整个代码库，理解项目结构

🔄

多轮迭代

持续修改直到满足要求

💰

成本低廉

使用便宜模型即可获得极好效果

💡

适用场景 大型重构、添加新功能、编写测试、代码迁移、技术债清理。

安装 Aider

前提条件

Python 3.10+
Git 2.23+
已初始化 Git 仓库的项目目录

安装方式

bash (推荐 pipx)

# Install pipx (if not already installed)
pip install pipx

# Install aider with pipx (recommended, isolated environment)
pipx install aider-chat

# Or install directly with pip
pip install aider-chat

验证安装：

bash

aider --version

配置 XiDao Api

Aider 使用 OpenAI 兼容接口，配置非常简单：

bash (macOS/Linux)

export OPENAI_API_KEY="sk-你的API_KEY"
export OPENAI_BASE_URL="https://api.xidao.online/v1"

powershell (Windows)

$env:OPENAI_API_KEY="sk-你的API_KEY"
$env:OPENAI_BASE_URL="https://api.xidao.online/v1"

持久化配置（推荐）

将上述命令写入 shell 配置文件（~/.zshrc 或 ~/.bashrc），然后执行 source ~/.zshrc

选择模型

Aider 支持通过 --model 参数指定模型，也可以通过环境变量 AIDER_MODEL 设置默认模型。

bash

# Use Claude Sonnet (recommended for daily use)
export AIDER_MODEL="claude-sonnet-4-5-20250929"

# Use Gemini Flash (for quick tasks)
export AIDER_MODEL="gemini-2.5-flash"

# Use GPT-5.1 Mini (great value)
export AIDER_MODEL="gpt-5.1-codex-mini"

使用方法

基本流程

进入项目目录

cd your-project — 必须是 git 仓库

启动 Aider

aider — 进入交互式配对模式

描述需求

用自然语言告诉 AI 你想要做什么

审查并确认

Aider 修改代码后，你可以审查变更并确认或拒绝

常用命令

命令	说明
`aider`	启动交互模式
`aider "添加用户认证"`	带初始消息启动
`aider --model gemini-2.5-flash`	指定模型
`aider --yes-always`	自动确认所有操作（谨慎使用）
`aider --file src/auth.ts`	只编辑特定文件
`/undo`	在聊天中撤销上一次操作

工作模式

🎯

Architect 模式

AI 作为架构师，先规划再实施。适合大型重构和新功能开发。

🛠️

Code 模式

AI 直接写代码，快速高效。适合小改动和明确任务。

📋

Ask 模式

纯问答模式，不修改代码。适合了解项目和获取建议。

高级技巧与最佳实践

与 Git 工作流配合

✅

Aider 最佳实践：
1. 先 git commit 当前工作（保存进度）
2. 运行 aider 让 AI 修改代码
3. 审查 AI 的修改，aider /undo 如需回退
4. 满意后再 git commit
5. 如有问题可 git revert 回退整个 aider session