Aider - AI结对编程助手完整指南
让 AI 直接在您的代码库中编写、重构和调试代码，自动 Git 提交，支持 GPT-4o、Claude 3.5 等模型
自动编辑文件
直接修改本地代码文件
Git 集成
自动提交有意义的 commit
语音输入
支持语音描述需求
多模型支持
GPT-4o、Claude、DeepSeek
一、快速安装
安装 Aider
pip install aider-chat二、配置文件详解
.aider.conf.yml 配置
# .aider.conf.yml
model: gpt-4o
auto-commits: true
auto-test: true
voice: true
watch: true
# 使用自定义 API
openai-api-base: https://api.n1n.ai/v1
openai-api-key: your-api-key-here
# Git 配置
git: true
gitignore: true
pretty: true
show-diffs: true
# 文件监控
watch-files:
- "*.py"
- "*.js"
- "*.ts"配置说明
- • model: 指定使用的模型（gpt-4o/claude-3-5-sonnet）
- • auto-commits: 自动提交代码变更
- • auto-test: 修改后自动运行测试
- • voice: 启用语音输入功能
- • watch: 监控文件变化
API 配置
- • openai-api-base: 自定义 API 地址
- • openai-api-key: API 密钥
- • 支持 OpenAI、Azure、自建服务
- • 兼容 OpenAI API 格式
三、基础使用方法
常用命令
# 基础使用
aider main.py
# 指定多个文件
aider src/*.py tests/*.py
# 使用语音输入
aider --voice main.py
# 监控文件变化
aider --watch src/💡 实用技巧
- • 使用
/add命令添加新文件到会话 - • 使用
/drop移除不需要的文件 - • 使用
/undo撤销最后的修改 - • 使用
/diff查看代码变更 - • 使用
/run执行 shell 命令
四、实战示例：构建完整功能
创建用户认证系统
# 创建一个复杂功能
$ aider main.py utils.py
> /add 请帮我实现一个用户认证系统，包括：
> 1. JWT token 生成和验证
> 2. 密码加密存储
> 3. 用户登录/注册接口
> 4. 中间件权限验证
# Aider 会自动：
# - 分析现有代码结构
# - 生成所需的新文件
# - 添加必要的依赖
# - 创建单元测试
# - 自动提交代码变更✨ Aider 的优势
- • 理解整个项目上下文
- • 自动处理导入和依赖
- • 生成符合项目风格的代码
- • 自动创建测试文件
- • 智能 Git 提交信息
🎯 最佳实践
- • 明确描述需求和预期结果
- • 分步骤实现复杂功能
- • 及时 review 生成的代码
- • 保持小而频繁的提交
- • 使用测试驱动开发
五、模型选择建议
GPT-4o
✅ 最强的代码理解能力
✅ 复杂逻辑实现
✅ 架构设计
💰 成本较高
aider --model gpt-4oClaude 3.5 Sonnet
✅ 优秀的代码质量
✅ 详细的解释
✅ 安全性更高
💚 性价比高
aider --model claude-3-5-sonnetDeepSeek Coder
✅ 专注代码生成
✅ 速度快
✅ 成本低
🚀 日常开发首选
aider --model deepseek-coder六、常见问题解决
如何使用自定义 API 端点？
export OPENAI_API_BASE="https://api.n1n.ai/v1" export OPENAI_API_KEY="your-api-key" aider --model gpt-4o main.py
如何限制修改范围？
使用 --read 参数指定只读文件：
aider main.py --read lib/*.py tests/*.py
如何处理大型代码库？
使用 map 模式减少 token 消耗：
aider --map-tokens 1024 --model gpt-4o-mini src/