Aider 接入指南
Aider 是终端 AI 编程助手，与 Git 深度集成。
🌟 为什么选择 Aider？
| 特点 | 说明 |
|---|---|
| 💻 终端原生 | 命令行工具 |
| 🔄 Git 集成 | 自动提交修改 |
| 📝 多文件编辑 | 同时编辑多个文件 |
| 🤖 多模型支持 | 支持多种 AI 模型 |
| 💰 开源免费 | 完全开源 |
📦 安装 Aider
使用 pip 安装
bash
# 安装 aider
pip install aider-chat
# 验证安装
aider --version使用 brew 安装（macOS）
bash
# 安装 aider
brew install aider
# 验证安装
aider --version🔧 配置 Next API
方法一：环境变量
bash
# 设置 API Key
export OPENAI_API_KEY="sk-你的密钥"
# 设置 Base URL
export OPENAI_API_BASE="https://api.nextapi.pro/v1"
# 设置默认模型
export OPENAI_MODEL="gpt-4o-mini"方法二：配置文件
创建 ~/.aider.conf.yml：
yaml
# API 配置
api-key: sk-你的密钥
api-base: https://api.nextapi.pro/v1
model: gpt-4o-mini
# Git 配置
auto-commits: true
commit-prompt: "AI: {message}"
# 编辑器配置
editor: code🚀 开始使用
启动 Aider
bash
# 进入项目目录
cd your-project
# 启动 aider
aider
# 或指定文件
aider main.py utils.py基本命令
| 命令 | 功能 |
|---|---|
add <file> | 添加文件到上下文 |
drop <file> | 移除文件 |
clear | 清空上下文 |
undo | 撤销上次修改 |
diff | 查看修改 |
help | 查看帮助 |
exit | 退出 aider |
示例 1：写新功能
bash
aider> add main.py
aider> 写一个函数，读取 JSON 文件并返回字典
AI: 好的！我来帮你写这个函数。
[编辑 main.py]
[Git commit: "Add json_reader function"]
✅ 已完成！示例 2：修复 Bug
bash
aider> add buggy_code.py
aider> 这个函数有 Bug，修复它
AI: 我发现了问题，让我修复它。
[编辑 buggy_code.py]
[Git commit: "Fix bug in function"]
✅ 已修复！示例 3：重构代码
bash
aider> add old_code.py new_code.py
aider> 将 old_code.py 的逻辑重构到 new_code.py
AI: 好的！我来重构代码。
[创建 new_code.py]
[编辑 old_code.py]
[Git commit: "Refactor code to new module"]
✅ 已完成！💡 使用技巧
1. 添加多个文件
bash
# 添加多个文件到上下文
aider main.py utils.py config.py
# 或在 aider 中添加
aider> add *.py2. 使用 Git
Aider 会自动提交修改：
bash
# 查看修改
aider> diff
# 撤销修改
aider> undo
# 查看 Git 历史
git log3. 选择合适的模型
| 任务 | 推荐模型 |
|---|---|
| 写代码 | claude-sonnet-4-6 或 deepseek-v3.1 |
| 修复 Bug | gpt-4o |
| 快速修改 | gpt-4o-mini |
4. 使用语音输入
bash
# 启用语音输入
aider --voice
# 按住空格键说话
aider> [按住空格] 写一个函数...🎯 推荐配置
开发配置
yaml
# ~/.aider.conf.yml
api-key: sk-你的密钥
api-base: https://api.nextapi.pro/v1
model: claude-sonnet-4-6
# Git 配置
auto-commits: true
commit-prompt: "AI: {message}"
# 功能配置
map-tokens: 2048
cache-prompts: true成本优化配置
yaml
# ~/.aider.conf.yml
api-key: sk-你的密钥
api-base: https://api.nextapi.pro/v1
model: deepseek-v3.1
# 限制 token
map-tokens: 1024
max-tokens: 2000❓ 常见问题
Q: Aider 会自动提交代码吗？
A: 是的，Aider 会自动提交修改到 Git。你可以用 undo 撤销。
Q: 如何查看 Aider 做了什么修改？
A:
bash
# 在 aider 中查看
aider> diff
# 或用 Git 查看
git diff
git logQ: Aider 支持 Git 以外的版本控制吗？
A: 目前只支持 Git。
Q: 如何切换模型？
A:
bash
# 方法一：命令行参数
aider --model gpt-4o
# 方法二：环境变量
export OPENAI_MODEL="gpt-4o"
# 方法三：配置文件
# 编辑 ~/.aider.conf.yml