Aider 接入 Gemma 4：2026 最强开源 AI 结对编程本地搭建指南
你可能已经听说过 Codex CLI、Cursor、Claude Code 这些 AI 编程工具。但如果你想要一个完全开源、本地运行、还能自动帮你 git commit 的 AI 结对编程助手，Aider 是目前最成熟的选择。
问题来了——Aider 默认用 GPT-4 或 Claude 这类云端 API，每月费用不便宜，而且代码全部要发到第三方服务器。有没有办法接上本地模型，既不花钱又不泄露代码？
有。把 Gemma 4 通过 Ollama 跑在本地，再让 Aider 连过去，你就有了一个完全免费、完全私密的 AI 编程搭档。本篇指南会从零开始带你跑通整个流程，并给出 4 个真实场景的实战演示。
Aider 是什么？和其他工具有什么不同
Aider 是一个开源的终端 AI 编程工具（GitHub 30K+ stars），由 Paul Gauthier 从 2023 年开始维护。它的核心理念是 AI pair programming——不只是生成代码片段，而是理解你整个项目的上下文，直接在代码仓库里做修改，还能自动创建 git commit。
和市面上其他工具对比：
| 特性 | Aider | Codex CLI | Cursor | Claude Code |
|---|---|---|---|---|
| 开源协议 | Apache 2.0 完全开源 | 部分开源 | 闭源 | 闭源 |
| 多文件编辑 | 原生支持 | 单文件为主 | 支持 | 支持 |
| Git 自动提交 | 内置 commit + 描述生成 | 无 | 无 | 无 |
| Repo Map | 自动构建项目结构图 | 无 | 部分支持 | 部分支持 |
| 本地模型 | 原生支持 Ollama / LiteLLM | 需配环境变量 | 需插件 | 不支持 |
| 费用 | 模型费用（本地=零） | API 费用 | $20/月 订阅 | API 费用 |
Aider 最大的杀手锏是 repo map——它会自动分析整个代码仓库的结构（文件、类、函数、依赖关系），在每轮对话中把相关上下文发给模型。这意味着 Gemma 4 不是在盲猜，而是真正"看懂"了你的项目。
如果你对 Codex CLI 方案感兴趣，也可以看我们的对比教程：Gemma 4 接入 Codex CLI 指南。
准备工作
开始之前确认你有：
- Python 3.9+（Aider 是 Python 项目）
- Ollama 已安装并运行（ollama.com）
- Gemma 4 26B 或 31B 通过 Ollama 下载完成
- 硬件：26B 至少 16GB 内存，31B 至少 24GB
不确定选哪个模型？看我们的 2026 本地 AI 模型选型指南。
第一步：安装 Aider
通过 pip 一行命令搞定：
pip install aider-chat验证安装：
aider --version应该看到 aider v0.x.x。如果你是 Mac/Linux 且 Python 环境比较乱，推荐用 pipx 隔离安装：
pipx install aider-chat第二步：启动 Ollama 并确认 Gemma 4 可用
确保 Ollama 服务在跑：
ollama serve另一个终端确认模型在线：
ollama list你应该看到类似这样的输出：
NAME ID SIZE MODIFIED
gemma4:26b-a4b abc123... 15 GB 2 hours ago如果列表里没有 Gemma 4，先下载：
ollama pull gemma4:26b-a4b第三步：用 Aider 连接本地 Gemma 4
Aider 原生支持 Ollama，配置极其简单。进入你的项目目录，运行：
cd /path/to/your/project
aider --model ollama/gemma4:26b-a4b就这样。Aider 会自动连接本地 Ollama 服务器（http://localhost:11434），用 Gemma 4 作为后端模型。
如果想每次都用这个配置而不用重复输入，可以在项目根目录创建 .aider.conf.yml：
model: ollama/gemma4:26b-a4b之后直接 aider 就会自动用 Gemma 4。
高级配置（可选）
Ollama 跑在远程机器或非默认端口：
aider --model ollama/gemma4:26b-a4b --ollama-api-base http://192.168.1.100:11434用一个"主模型"做编辑和"弱模型"做 commit 描述以省资源：
aider --model ollama/gemma4:26b-a4b --weak-model ollama/gemma4:e4b第四步：四个实战场景
场景 1：添加新功能
假设你有一个 Flask 项目，想加一个用户注册端点。在 Aider 对话里输入：
> 在 app.py 里添加一个 /register 端点，接收 email 和 password，做基本校验，存到 SQLiteAider 会：
- 读取项目 repo map，理解现有结构
- 修改
app.py（或创建新文件） - 显示 diff 让你确认
- 确认后自动
git commit -m "feat: add /register endpoint with email/password validation"
整个过程你不需要复制粘贴任何代码。
场景 2：跨文件重构
> 把 utils.py 里的数据库操作提取到新文件 db.py，更新所有 import这是 Aider 的强项。它会同时修改 utils.py、新建 db.py、更新所有引用旧路径的文件——然后一次性 commit。Codex CLI 做不到这种跨文件联动。
场景 3：修 Bug
> 测试 test_auth.py 里的 test_login_invalid_password 失败了，错误信息是 "AssertionError: 200 != 401"，帮我修Aider 会分析测试代码和被测代码，定位逻辑错误，修复后重跑测试确认。
场景 4：添加测试
> 给 db.py 里的所有公开函数写单元测试，用 pytestAider 会自动创建 test_db.py，为每个函数生成测试用例，覆盖正常路径和边界情况。
Gemma 4 在 Aider 里的实际表现
坦白说，Gemma 4 26B 在 Aider 中的表现不如 GPT-4 或 Claude 3.5——但日常开发够用。
擅长的场景：
- 单文件内的代码生成和修改
- 简单的跨文件重构（2-3 个文件）
- Bug 修复（给了明确错误信息时）
- 生成测试代码
- 代码解释
勉强的场景：
- 复杂的多文件架构改造（5+ 文件同时改）
- 需要深度理解框架约定的任务
- 非常长的上下文（Gemma 4 26B 支持 128K，但实际效果在 32K 后下降）
建议策略： 日常用 Gemma 4 26B（免费快速），复杂任务切回 aider --model gpt-4o（需要 API key）。两者可以在同一个项目里随时切换，git 历史完全兼容。
常见问题排查
Aider 报错 "Model not found"
检查 Ollama 是否在运行（curl http://localhost:11434/v1/models），以及模型名是否和 ollama list 输出完全一致。Aider 需要加前缀 ollama/，例如 ollama/gemma4:26b-a4b。
响应速度太慢
Gemma 4 26B 在 MacBook M1 上大约 20-40 tokens/s，长代码生成可能需要 30-60 秒。如果实在太慢：
- 检查是否在用 CPU 而非 GPU（
ollama ps查看） - 考虑更小量化版本
- 或者用 E4B 做日常任务，复杂任务再切 26B
不想要自动 commit
加 --no-auto-commits：
aider --model ollama/gemma4:26b-a4b --no-auto-commits这样 Aider 只修改文件，不自动提交。
输出质量差或乱码
多数是上下文不足导致。用 /drop 命令移除不需要的文件，或用 /tokens 查看当前上下文占用。
常见问题（FAQ）
Q：Aider 免费吗？ A：Aider 本身完全免费开源（Apache 2.0）。费用取决于你用什么模型——接本地 Gemma 4 = 零成本。
Q：Aider 和 Cursor 比怎么样？ A：Cursor 是 GUI 编辑器（基于 VS Code），适合喜欢可视化操作的人。Aider 是纯终端工具，适合习惯命令行的开发者。Aider 的 git 自动提交和 repo map 是 Cursor 没有的。两者不冲突，可以在同一个项目里混合使用。
Q：能用 Gemma 4 E2B（4B）跑 Aider 吗？ A：技术上可以，但 4B 的代码生成质量太差，基本不可用。最低建议 E4B（8B）做简单任务，正经开发用 26B 起步。
Q：Windows 能用吗？ A：可以。Python 和 Ollama 都支持 Windows，Aider 在 Windows Terminal 或 PowerShell 里正常工作。
Q：Aider 支持哪些编程语言？ A：几乎所有语言。Aider 通过 tree-sitter 构建 repo map，支持 Python、JavaScript/TypeScript、Go、Rust、Java、C/C++、Ruby 等 50+ 种语言。
Q：Gemma 4 和 Qwen 3 在 Aider 里哪个好？ A：社区反馈 Gemma 4 26B 在指令跟随方面更稳定，Qwen 3 27B 有时不按 Aider 的 diff 格式输出导致失败。详见 Gemma 4 vs Qwen 3 全面对比。
Q：能在服务器上跑 Aider + Gemma 4 远程使用吗？
A：可以。在 GPU 服务器上跑 Ollama，本地 SSH 连上后运行 Aider，把 --ollama-api-base 指向服务器 IP 即可。
Related Articles
- Gemma 4 接入 Codex CLI 指南 — 另一种终端 AI 编程方案对比
- Gemma 4 vs Qwen 3 全面对比 — 竞品选型参考
- 2026 本地 AI 模型选型指南 — 选对模型再开工
Stop reading. Start building.
~/gemma4 $ Get hands-on with the models discussed in this guide. No deployment, no friction, 100% free playground.
Launch Playground />
