forked from Kexing/AI4SE_Practices
175 lines
3.8 KiB
Markdown
175 lines
3.8 KiB
Markdown
# Aider - 安装配置指南
|
||
|
||
## 📋 前置要求
|
||
|
||
### 系统要求
|
||
|
||
- **操作系统**：macOS 12+ / Windows 10+ / Linux（Ubuntu 20.04+ 推荐）
|
||
- **硬件要求**：普通 CPU + 8GB 内存（若使用本地模型，建议 16GB+ RAM + GPU）
|
||
- **网络要求**：✅ 需要互联网连接（用于调用 LLM API 或下载模型）
|
||
|
||
### 依赖安装
|
||
|
||
#### Python环境（必需）
|
||
|
||
```bash
|
||
python --version # 需要 Python 3.9+
|
||
pip --version # 建议 pip 23.0+
|
||
```
|
||
|
||
> 注意：Aider 本身是 Python 工具，必须通过 Python 安装。
|
||
|
||
#### 其他依赖
|
||
|
||
- **Git**：✅ 必需（用于代码追踪与自动提交）
|
||
- **可选**：Ollama（用于本地模型）、FFmpeg（用于语音输入）
|
||
|
||
## 🔧 安装步骤
|
||
|
||
### 方式1：本地 CLI 安装（推荐）
|
||
|
||
```bash
|
||
# 安装 Aider
|
||
pip install aider-chat
|
||
|
||
# 验证安装
|
||
aider --help
|
||
```
|
||
|
||
> 注意：包名为 `aider-chat`，不是 `aider`。
|
||
|
||
### 方式2：使用特定 LLM API
|
||
|
||
#### 配置 OpenAI（o3-mini 示例）
|
||
|
||
```bash
|
||
aider --model o3-mini --api-key openai=sk-xxxxxx
|
||
```
|
||
|
||
#### 配置 Anthropic（Claude 3.7 Sonnet）
|
||
|
||
```bash
|
||
aider --model sonnet --api-key anthropic=sk-ant-xxxxxx
|
||
```
|
||
|
||
#### 配置 DeepSeek
|
||
|
||
```bash
|
||
aider --model deepseek --api-key deepseek=dpk-xxxxxx
|
||
```
|
||
|
||
### 方式3：本地模型支持（通过 Ollama）
|
||
|
||
1. 安装 [Ollama](https://ollama.com/)
|
||
2. 拉取模型（如 Qwen、Llama3）：
|
||
```bash
|
||
ollama pull qwen:7b
|
||
```
|
||
3. 启动 Aider 并指定本地模型：
|
||
```bash
|
||
aider --model ollama/qwen:7b
|
||
```
|
||
|
||
> Aider 自动检测 Ollama 服务（默认 `http://localhost:11434`）
|
||
|
||
## ⚙️ 配置说明
|
||
|
||
### API密钥配置（推荐使用环境变量）
|
||
|
||
```bash
|
||
# 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 支持自动加载）：
|
||
|
||
```env
|
||
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 环境变量
|
||
|
||
## ✅ 验证安装
|
||
|
||
### 检查版本
|
||
|
||
```bash
|
||
aider --version
|
||
# 输出示例：aider 0.86.0
|
||
```
|
||
|
||
### 测试基本功能
|
||
|
||
```bash
|
||
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 脚本目录
|
||
|
||
**解决方案**：
|
||
```bash
|
||
# 使用 python -m 调用
|
||
python -m aider --help
|
||
|
||
# 或重新安装
|
||
pip install --force-reinstall aider-chat
|
||
```
|
||
|
||
### 问题2：LLM 返回错误或超时
|
||
|
||
**原因**：API 密钥无效、网络不通、模型配额耗尽
|
||
|
||
**解决方案**：
|
||
- 检查密钥是否正确
|
||
- 使用 `curl` 测试 API 连通性
|
||
- 尝试切换模型（如从 GPT-4o 切换到 o3-mini）
|
||
|
||
### 问题3：Git 提交失败
|
||
|
||
**原因**：未配置 Git 用户名/邮箱
|
||
|
||
**解决方案**：
|
||
```bash
|
||
git config --global user.name "Your Name"
|
||
git config --global user.email "you@example.com"
|
||
```
|
||
|
||
### 问题4：本地模型无法连接 Ollama
|
||
|
||
**原因**：Ollama 未运行或端口被占用
|
||
|
||
**解决方案**：
|
||
```bash
|
||
# 确保 Ollama 正在运行
|
||
ollama list
|
||
|
||
# 检查端口
|
||
curl http://localhost:11434
|
||
```
|
||
|
||
## 🔗 相关链接
|
||
|
||
- [官方安装指南](https://aider.chat/docs/install.html)
|
||
- [LLM 配置文档](https://aider.chat/docs/llms.html)
|
||
- [GitHub Issues](https://github.com/Aider-AI/aider/issues)
|
||
|
||
---
|
||
|
||
> **提示**：Aider 是纯 CLI 工具，无需复杂 IDE 插件。其核心优势在于 **Git 集成 + 全库上下文理解**，特别适合 DevOps 场景下的自动化编码与维护。 |