Aider为什么值得用

Cursor、Windsurf 这类图形化 AI IDE 功能强大但绑定特定编辑器。Aider 走另一条路：纯终端 CLI，原生 Git 集成，多模型支持，开源免费。对习惯 Vim/Neovim、终端生活、SSH 远程开发的工程师来说，Aider 是更顺手的工具。更重要的是 Aider 自动创建 Git commit，每个 AI 修改都成为一个独立提交，回滚和审查极其方便。

第一步：安装

  1. 需要 Python 3.8+，安装：pip install aider-install
  2. 运行安装脚本：aider-install（会自动装好依赖）
  3. Mac 可用 brew install aider，Linux 可用 pipx install aider-chat
  4. 验证：aider –version

第二步：配置模型和API Key

  1. 环境变量配置（推荐）：
    – export OPENAI_API_KEY=sk-xxx（GPT-4o）
    – export ANTHROPIC_API_KEY=sk-ant-xxx（Claude Sonnet 4）
    – export DEEPSEEK_API_KEY=sk-xxx（DeepSeek V3，性价比首选）
  2. 启动时指定模型：aider –model deepseek
  3. 配置文件 ~/.aider.conf.yml 永久保存偏好

第三步：第一个任务

  1. cd 到项目目录
  2. aider src/main.py（让 Aider 知道要操作的文件）
  3. Aider 进入 REPL，类似 ChatGPT 但操作真实文件
  4. 输入：’给这个函数加单元测试’
  5. Aider 会读取文件、生成代码、自动 git commit

第四步：多文件编辑

  1. 启动时加多个文件：aider src/api.ts src/types.ts src/utils.ts
  2. 指令：’在所有 API 调用处加上错误处理’
  3. Aider 列出所有改动，每个文件显示 diff
  4. 每个文件改动后自动 git commit，commit message 自动生成

第五步：仓库级上下文

Aider 默认会扫描整个 Git 仓库作为上下文：

  • 智能识别相关文件，无需手动指定所有文件
  • 大型项目可加 –map-tokens 限制上下文大小（默认 1024 tokens）
  • –auto-lint 自动运行 lint 检查
  • –auto-test 自动跑测试

第六步：Voice 语音模式

支持用语音和 Aider 对话：

  1. 需要安装：pip install aider-chat[voice]
  2. 启动：aider –voice –model gpt-4o
  3. 按住空格键说话，松开后 Aider 识别语音并执行
  4. 适合长时间编程懒得打字的场景

第七步：常用工作流

工作流1：新功能开发

  1. aider src/feature/
  2. ‘基于这个目录的代码结构，添加一个新功能…’
  3. Aider 创建新文件、修改现有依赖、运行测试

工作流2：Bug 修复

  1. aider –model claude-3-5-sonnet
  2. ‘这个 bug 我已经定位到 xxx，参考最近的 git log，帮我修复’

工作流3：代码审查

  1. git checkout -b review-branch
  2. aider src/
  3. ‘审查这个分支的改动，给出改进建议’

工作流4：迁移升级

  1. aider –model deepseek
  2. ‘把所有 var 改为 const 或 let，根据可变性判断’

第八步：镜像加速

国内用户访问 OpenAI/Claude 慢，可配镜像：

export OPENAI_API_BASE=https://api.deepseek.com/v1
export ANTHROPIC_API_BASE=https://your-mirror.com/v1

推荐模型（按性价比排序）：

  • DeepSeek V3：中文场景首选，价格 $0.14/$0.28 每百万 token
  • GPT-4o-mini：速度快，适合简单任务
  • Claude 3.5 Sonnet：质量最高，适合复杂重构
  • Qwen2.5-Coder：开源可本地部署

第九步：与编辑器集成

虽然 Aider 是 CLI，但可以和编辑器联动：

  • Vim/Neovim：用 vim-slash 或 aider.nvim 插件，让 Aider 在 Vim 里交互
  • VS Code：用 VSCode 终端跑 Aider，光标位置自动同步到 Aider
  • tmux：分屏让 Aider 和编辑器并排显示

常见问题与误区

  • 自动 commit 太频繁：用 –no-auto-commits 关闭，或用 /commit 手动控制
  • 大仓库扫不全：手动指定关键文件：aider src/api.py src/models.py
  • 中文乱码：终端需要 UTF-8 编码，建议用 iTerm2/Windows Terminal
  • API 费用高：用 –model gpt-4o-mini 或 DeepSeek 控制成本

与 Cursor 对比

Aider vs Cursor：Aider 终端友好、Git 原生、开源免费，Cursor 图形界面好、Composer 跨文件编辑更强。对纯文字开发者 Aider 体验更自然，对需要可视化 diff 审阅 Cursor 更直观。

效率数据

实测对比：中型项目（100+ 文件）做类型注解补全，传统手动约 4-6 小时，Aider 平均 30 分钟完成初版。代码迁移类任务（如 JS → TS）从 2 天压缩到 3 小时，效率提升 6 倍。