cccyyt
/
AI4SE_Practices
forked from Kexing/AI4SE_Practices
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
AI4SE_Practices/AI4SE-survey/tools/devops-ci-cd/aider/setup-guide.md

3.8 KiB
Raw Blame History

Aider - 安装配置指南

📋 前置要求

系统要求

  • 操作系统：macOS 12+ / Windows 10+ / Linux（Ubuntu 20.04+ 推荐）
  • 硬件要求：普通 CPU + 8GB 内存（若使用本地模型，建议 16GB+ RAM + GPU）
  • 网络要求：✅ 需要互联网连接（用于调用 LLM API 或下载模型）

依赖安装

Python环境（必需）

python --version  # 需要 Python 3.9+
pip --version     # 建议 pip 23.0+

注意：Aider 本身是 Python 工具，必须通过 Python 安装。

其他依赖

  • Git：✅ 必需（用于代码追踪与自动提交）
  • 可选：Ollama（用于本地模型）、FFmpeg（用于语音输入）

🔧 安装步骤

方式1：本地 CLI 安装（推荐）

# 安装 Aider
pip install aider-chat

# 验证安装
aider --help

注意：包名为 aider-chat，不是 aider。

方式2：使用特定 LLM API

配置 OpenAI（o3-mini 示例）

aider --model o3-mini --api-key openai=sk-xxxxxx

配置 Anthropic（Claude 3.7 Sonnet）

aider --model sonnet --api-key anthropic=sk-ant-xxxxxx

配置 DeepSeek

aider --model deepseek --api-key deepseek=dpk-xxxxxx

方式3：本地模型支持（通过 Ollama）

  1. 安装 Ollama
  2. 拉取模型（如 Qwen、Llama3）： 
    ollama pull qwen:7b
  3. 启动 Aider 并指定本地模型： 
    aider --model ollama/qwen:7b

Aider 自动检测 Ollama 服务（默认 http://localhost:11434）

⚙️ 配置说明

API密钥配置（推荐使用环境变量）

# macOS/Linux
export OPENAI_API_KEY="sk-xxxx"
export ANTHROPIC_API_KEY="sk-ant-xxxx"

# Windows (PowerShell)
$env:OPENAI_API_KEY="sk-xxxx"

或使用 .env 文件（Aider 支持自动加载）：

OPENAI_API_KEY=sk-xxxx
ANTHROPIC_API_KEY=sk-ant-xxxx

其他配置选项

  • 模型选择：通过 --model 参数指定（如 sonnet, o3-mini, deepseek, ollama/llama3）
  • 自动测试：在项目根目录放置 pytest.ini 或 Makefile，Aider 会自动运行测试
  • 代理设置：支持标准 HTTP_PROXY / HTTPS_PROXY 环境变量

✅ 验证安装

检查版本

aider --version
# 输出示例：aider 0.86.0

测试基本功能

cd /your/project
echo "# TODO: add hello function" > todo.md
aider todo.md --model o3-mini

Aider 会读取指令并生成代码，自动提交到 Git。

🔍 常见问题

问题1：command not found: aider

原因：未正确安装或 PATH 未包含 Python 脚本目录

解决方案：

# 使用 python -m 调用
python -m aider --help

# 或重新安装
pip install --force-reinstall aider-chat

问题2：LLM 返回错误或超时

原因：API 密钥无效、网络不通、模型配额耗尽

解决方案：

  • 检查密钥是否正确
  • 使用 curl 测试 API 连通性
  • 尝试切换模型（如从 GPT-4o 切换到 o3-mini）

问题3：Git 提交失败

原因：未配置 Git 用户名/邮箱

解决方案：

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

问题4：本地模型无法连接 Ollama

原因：Ollama 未运行或端口被占用

解决方案：

# 确保 Ollama 正在运行
ollama list

# 检查端口
curl http://localhost:11434

🔗 相关链接

提示：Aider 是纯 CLI 工具，无需复杂 IDE 插件。其核心优势在于 Git 集成 + 全库上下文理解，特别适合 DevOps 场景下的自动化编码与维护。