概述

Aider 是一个终端中的 AI 编程助手，支持 GPT-4、Claude 等模型，可以编辑本地代码仓库中的文件，并与 Git 无缝集成。

安装

# 使用 pip 安装
pip install aider-chat

# 使用 Homebrew
brew install aider-chat

# 验证安装
aider --version

基本用法

启动

# 在当前目录启动
aider

# 在指定仓库启动
aider /path/to/repo

# 指定模型
aider --model gpt-4

添加文件

# 添加单个文件
aider add src/app.py

# 添加多个文件
aider add src/app.py tests/test_app.py

# 添加所有修改的文件
aider add .

# 添加符合模式的文件
aider add *.py

编辑文件

# 在 Aider 中输入
/edit 修改 get_user 函数，添加缓存支持

# 或使用完整描述
/create 修改 app.py 中的 API 端点，添加参数验证和错误处理

Git 集成

自动提交

# 启用自动 commit
aider --auto-commit

# 每次修改后自动生成 commit message
aider
# > /add src/app.py
# > 修改了 get_user 函数
# > Aider 自动 commit

Commit 消息生成

# 手动生成 commit
aider --commit

# 指定 commit 类型
aider --commit --commit-type feat

# 查看 commit 历史
git log --oneline -10

分支管理

# 创建新分支
aider --git-branch feature/new-api

# 查看分支
aider --list-branches

# 切换分支
aider --git-branch main

完整工作流

# 1. 启动 Aider
aider --model claude-3-5-sonnet

# 2. 添加要编辑的文件
aider add src/api.py tests/test_api.py

# 3. 描述要做的修改
> 重构 API 端点，添加认证中间件

# 4. Aider 修改代码，显示 diff

# 5. 确认修改
> y

# 6. Aider 自动 commit
git commit -m "feat: 添加 API 认证中间件"

配置

# 创建配置文件
mkdir -p ~/.aider

# 设置 API Key
export OPENAI_API_KEY=sk-...

# 或使用 .env 文件
aider --env-file .env

参考资料

• Aider 官方文档
• Aider GitHub