📌 项目简介
Aider 是一款终端原生 AI 结对编程工具，支持搭配各大云端/本地大语言模型（LLM）开启新项目或在现有代码库基础上进行开发。它由 Paul Gauthier 独立开发维护，GitHub 获得 42K+ Stars，是 2026 年最热门的开源 AI 编程助手之一。
Aider-AI 组织头像
⚙️ 安装要求和过程
环境要求
- Python：3.8 – 3.14（实验性支持 3.14）
- pip：最新版本
- Git：用于版本控制集成
- 网络：访问 LLM API（或本地模型）
快速安装步骤
-
安装 aider-install 工具
python -m pip install aider-install aider-install -
进入项目目录
cd /path/to/your/project -
配置模型（选择其一）
# DeepSeek（推荐，性价比高） aider --model deepseek --api-key deepseek=<your-key> # Claude 3.7 Sonnet（最强代码能力） aider --model sonnet --api-key anthropic=<your-key> # OpenAI o3-mini aider --model o3-mini --api-key openai=<your-key> # 本地模型（Ollama） aider --model ollama/llama3 -
开始编程！
# 启动 aider aider # 在 aider 中直接对话 > 帮我实现一个用户登录功能 > 修复这个 bug > 优化这段代码的性能
🌟 核心功能
1. 全模型兼容 —— BYOK 模式
Aider 采用 BYOK（Bring Your Own Key） 模式，支持几乎所有主流 LLM：
- Claude：3.5 Haiku、3.7 Sonnet、Opus 4.1
- OpenAI：o1、o3-mini、GPT-4o、GPT-5.5
- DeepSeek：R1、Chat V3（推荐，性价比极高）
- Google：Gemini 3.1 Pro
- 本地模型：Ollama、LM Studio、vLLM
2. Repo Map —— 智能代码库映射
Aider 会自动分析整个代码库，生成智能映射（Repo Map），让 LLM 理解项目结构：
- 自动识别所有源代码文件
- 提取函数、类、方法签名
- 建立文件之间的依赖关系图
- 即使是大项目（100+ 文件），AI 也能精准定位需要修改的位置
3. Git 原生集成 —— 自动提交
Aider 与 Git 深度集成，每次 AI 修改代码后：
- 自动生成合理的提交信息（符合 Conventional Commits 规范）
- 可通过
/diff查看 AI 的修改 - 可通过
/undo撤销上一次 AI 修改 - 支持
/git命令直接管理版本控制
# 查看 AI 的修改
> /diff
# 撤销上一次修改
> /undo
# 手动提交
> /git add . && git commit -m "xxx"4. 多模态输入 + 语音转代码
Aider 支持丰富的输入方式：
- 图片输入：可向对话中添加截图、设计稿、流程图，AI 会根据视觉内容生成代码
- 网页上下文：可添加 URL，AI 会自动抓取网页内容作为参考
- 语音输入：支持语音转文字，直接”说”出需求，AI 自动实现
# 添加图片
> /add screenshot.png
> 根据这个设计稿实现界面
# 添加网页
> /web https://example.com
> 参考这个页面的布局5. 自动 Lint & 测试修复
Aider 每次修改代码后，会自动执行 linter 和测试套件：
- 如果检测到 lint 错误（如 pylint、eslint），自动修复
- 如果测试失败，自动分析错误并修复代码
- 支持自定义 linter 和测试命令
# 配置 .aider.conf.yml
lint_cmds:
- ["python", "-m", "pylint", "--disable=all", "--enable=F,E", "--errors-only", "/dev/stdin"]
test_cmd: ["python", "-m", "pytest", "tests/"]🚀 典型使用场景
场景 1：快速原型开发
需求：需要快速实现一个 Web 应用原型，验证想法。
工作流：
# 1. 创建项目目录
mkdir my-app && cd my-app
git init
# 2. 启动 aider
aider --model deepseek
# 3. 描述需求
> 创建一个 Flask 应用，包含用户注册、登录、主页
> 使用 SQLite 数据库
> 前端使用 Bootstrap 5
# 4. Aider 自动生成代码并提交
# 每次修改都会自动 git commit效果：10 分钟内完成原型开发，自动提交 5-10 个 Git 版本。
场景 2：遗留代码重构
需求：有一个旧的 Python 2 项目，需要迁移到 Python 3，并重构优化。
工作流：
# 1. 进入项目目录
cd legacy-project
aider --model claude
# 2. 让 Aider 分析代码库
> 分析这个项目的结构，列出需要迁移的地方
# 3. 逐步重构
> 将这些 Python 2 代码迁移到 Python 3
> 优化这个函数的时间复杂度
> 添加类型注解效果：Aider 的 Repo Map 能理解整个代码库，精准修改所有需要改动的地方，并自动提交每个步骤。
场景 3：Bug 修复 & 调试
需求：生产环境出现 bug，需要快速定位并修复。
工作流：
# 1. 启动 aider
cd production-app
aider
# 2. 描述 bug
> 用户报告点击"提交订单"按钮后页面报错
> 错误信息是 "NullPointerError at line 42 in order.py"
> 帮我定位和修复这个 bug
# 3. Aider 自动分析
# - 读取 order.py 和相关文件
# - 定位问题（如未判空）
# - 修复代码
# - 自动提交：fix: handle None case in order submission
# 4. 运行测试
> /test效果：从 bug 报告到修复提交，全程 5 分钟。
💡 推荐理由
我（数字生命卡兹克）在使用过 Cursor、GitHub Copilot、Kilo Code 等众多 AI 编程工具后，必须说：
Aider 是我见过最”懂 Git”的 AI 编程助手。
为什么推荐 Aider？
- 终端原生，无 IDE 锁定
不需要特定的 IDE 或编辑器，在任何终端都能用。配合 tmux/vim/emacs 简直是神器。 - Git 集成无与伦比
每次修改都自动提交，提交信息质量极高（比我自己写的还好）。可随时/undo，版本控制安全感拉满。 - Repo Map 黑科技
大项目也不慌，Aider 能理解整个代码库的结构，不会出现”改了 A 文件忘了改 B 文件”的低级错误。 - 性价比极高
配合 DeepSeek API，一个月不到 10 块钱，能用几百次。比 Cursor 订阅便宜太多了。 - 开源 & 隐私优先
Apache 2.0 许可，代码完全透明。也可以用本地模型（Ollama），代码不出本地。
适合人群
- 🐧 终端爱好者：喜欢在终端里完成所有工作
- 🧑💻 全栈开发者：需要快速原型开发、重构遗留代码
- 🔧 DevOps/SRE：写脚本、自动化工具
- 🎓 学生/初学者：学习代码最佳实践（Aider 的代码质量很高）
小技巧
- 使用
--watch模式，Aider 会自动监控文件变化并自动 commit - 配置
.aiderignore排除不需要 AI 看的敏感文件 - 使用
/add命令添加上下文文件，让 AI 更懂你的意图 - 配合
tmux使用，一边 aider 一边手动修改，效率翻倍
📥 下载地址
快速安装
# 方式一：使用 aider-install（推荐）
python -m pip install aider-install
aider-install
# 方式二：直接安装
pip install aider-chat
# 方式三：使用 pipx（隔离环境）
pipx install aider-chat系统要求
- Python：3.8 – 3.14
- 支持系统：Windows / macOS / Linux
- 许可证：Apache 2.0（完全开源）
- GitHub Stars：42K+（持续增长中）
🎁 总结
Aider 是一款终端原生、Git 深度集成、支持全模型的 AI 结对编程工具。它不试图替代你的 IDE，而是成为你终端工作流的一部分。
如果你喜欢在终端里工作，追求极致的版本控制体验，或者想要一个高性价比的 AI 编程助手，Aider 绝对值得一试！strong>
🌟 给 Aider 一个 Star：https://github.com/Aider-AI/aider