Aider 能在终端中与你进行 AI 结对编程的强大工具 | 极客的赛博空间

🧭 Aider 是什么？

Aider 是一个命令行 AI 编程助手，它能直接在你的代码仓库中工作，帮助你完成从创建新项目到改进现有代码的各种任务。它的核心优势在于：

深度代码库理解：通过构建整个代码库的映射（repo map），在大型项目中也能表现出色。
强大的 Git 集成：自动为 AI 的每次修改生成有意义的提交信息，让你可以轻松地管理、对比和撤销变更。
灵活的 LLM 支持：既支持最前沿的云端模型（如 Claude 3.7 Sonnet、DeepSeek），也支持本地模型。
多语言与多模式：支持超过100种编程语言，并能通过图像、网页链接和语音进行交互。

📦 安装与配置

1. 安装 Aider

官方推荐使用 aider-install 引导程序进行安装，这是最简洁的方式：

# 安装引导程序
python -m pip install aider-install

# 运行安装程序
aider-install

安装完成后，你就可以在终端中使用 aider 命令了。

2. 配置 API 密钥

Aider 本身免费，但需要你提供所选择 LLM 的 API 密钥。你可以通过环境变量或命令行参数来设置。

方式一：环境变量（推荐）
在终端的配置文件（如 ~/.bashrc, ~/.zshrc）中添加：

# 例如，使用 Anthropic (Claude) 的密钥
export ANTHROPIC_API_KEY="你的-Anthropic-API-密钥"

# 或使用 OpenAI 的密钥
export OPENAI_API_KEY="你的-OpenAI-API-密钥"

# 或使用 DeepSeek 的密钥
export DEEPSEEK_API_KEY="你的-DeepSeek-API-密钥"

方式二：命令行参数
每次启动 Aider 时通过 --api-key 参数指定：

1	aider --model sonnet --api-key anthropic=你的-Anthropic-密钥

🚀 快速上手与核心用法

基本用法

进入你的项目目录：
1
cd /path/to/your/project

启动 Aider：

# 默认会尝试使用 Claude 3.5 Sonnet（如果配置了 ANTHROPIC_API_KEY）
aider

# 或指定使用的模型
aider --model deepseek

启动后，你会进入一个交互式聊天界面。

开始对话与编程：
在聊天界面中，你可以用自然语言提出请求，Aider 会理解并执行。

1
2
3

> 为 utils.py 中的 calculate_average 函数编写单元测试
> 解释一下当前项目中认证流程的实现逻辑
> 在现有代码基础上，添加一个处理用户上传头像的功能

Aider 会分析你的代码库，做出修改，并自动用 Git 提交这些更改。

核心工作流与特性

在 IDE 中集成：你可以从 Visual Studio Code 等 IDE 中使用 Aider。通过快捷键或命令面板运行 Aider: Start 即可。
代码审查与修复：Aider 可以读取你的 linter 和测试套件的输出，并自主修复发现的问题。
语音交互：通过配置，你可以直接用语音向 Aider 描述需求，实现“语音到代码”的编程体验。
图像与网页上下文：你可以将截图或网页链接“粘贴”到 Aider 的聊天中，提供视觉参考或技术文档上下文。

🔧 进阶配置与优化

1. 使用本地或自定义 LLM

Aider 可以通过配置连接到多种本地模型（如通过 Ollama 或 LM Studio 运行的模型）。关键在于指定正确的 API 端点和模型名称。

1 2	# 例如，连接本地运行的 Ollama 服务 aider --model ollama/llama3

2. 配置选项

Aider 提供了丰富的配置选项，你可以通过命令行参数或环境变量进行设置。一些常用参数包括：

--model <模型名>：选择要使用的 LLM。
--edit-format <格式>：选择 AI 生成代码的格式（如 diff、whole）。
--auto-commits 和 --dirty-commits：控制 Git 提交的行为。
--cache-prompts：缓存提示以提高性能。

📋 常用命令速查表

命令 / 操作	说明
`aider`	在项目目录下启动 Aider 交互会话
`aider --model <模型>`	启动时指定 LLM 模型
`aider --help`	查看所有命令行参数帮助
`aider --install-completion`	为你的 Shell 安装命令补全
在聊天中输入 `/help`	显示交互式会话内的命令帮助
在聊天中输入 `/commit`	手动触发 Git 提交
在聊天中输入 `/undo`	撤销最后一次 AI 修改

💡 最佳实践与故障排查

从简单开始：初次使用，先让 Aider 处理小型、明确的任务，逐步熟悉其交互方式。
善用代码地图：Aider 的代码库映射功能是其强大之处。对于大型项目，确保项目结构清晰，以便 Aider 能更好地理解。
管理 Git 历史：Aider 自动提交能让你放心尝试。但请务必定期检查提交历史和代码变更，确保 AI 的修改符合预期。
API 密钥问题：如果遇到认证错误，首先检查 ANTHROPIC_API_KEY 等环境变量是否正确设置并已生效（可能需要重启终端）。
查看官方文档：遇到具体问题时，Aider 的官方文档和 Discord 社区是极好的求助资源。

总结

Aider 将 AI 的强大能力直接带入你的终端和开发工作流。强烈建议新用户从运行 aider --help 开始，了解所有可用选项。然后，在你的代码库中启动一个简单的会话，从“为当前文件添加注释”或“解释这段代码的功能”这类非破坏性任务开始，逐步体验 Aider 如何成为你高效的 AI 结对编程伙伴。