Aider：终端里的AI结对编程特种兵

痛点引入

你有没有过这种时刻？

• 改一个登录模块，grep 17 个文件，手动比对 JWT Token 生成逻辑、Refresh Token 过期策略、OAuth2 授权码流转路径，改完发现漏了 SecurityConfig.java 里一个 permitAll() 没删；
• 写单元测试时对着 UserService.login() 方法发呆，不确定它到底依赖了 TokenService 还是 JwtUtil，最后靠打断点+日志硬啃；
• 提交前写 commit message，反复删改三次：fix: login, feat: jwt auth, refactor(auth): migrate to OAuth2 + JWT + RT rotation——直到 CI 流水线报 subject too long。

这些不是 bug，是现代全栈开发中上下文丢失的慢性病。IDE 的跳转和搜索救不了你，因为它们不理解「这个登录流程在业务上该怎样被替换」，只认得「这个方法名在哪被调用」。

解决方案：Aider 的三把手术刀

Aider 不是给你一个更聪明的补全框，而是给你一套可审计、可回滚、可 Git 版本化的 AI 编程手术刀。它有三把主刃：

1. repomap —— 代码库的语义导航图
2. git-aware editing —— 每次修改都自动 git add -p
3. LLM prompt engineering for code —— 不是自由聊天，而是结构化指令解析

它不做 IDE，不画 GUI，就蹲在你的 zsh 里，等你一句 aider --model sonnet，然后开始精准切片。

核心代码解析：repomap 是怎么“看懂”你项目的？

Aider 的 magic 不在 LLM，而在它如何把代码变成 LLM 能吃的 token。关键就在 aider/repomap.py —— 它不是用 AST 全量解析（太重），也不是简单正则（太糙），而是用多层轻量静态分析构建关系图谱：

## aider/repomap.py 核心逻辑节选（已简化）
def build_repomap(self, files):
    """
    构建代码地图：仅扫描 import、class def、method call、注释关键词
    不执行代码，不加载模块，纯文本+语法糖分析
    """
    graph = nx.DiGraph()
    
    for file in files:
        # Step 1: 提取类/函数定义（Python）或 public class / @RestController（Java）
        defs = self._extract_definitions(file)  # 返回 [("UserService", "class"), ("login", "method")]
        
        # Step 2: 扫描 import / require / @Autowired 行，建立依赖边
        imports = self._extract_imports(file)  # 返回 ["TokenService", "JwtUtil"]
        for imp in imports:
            graph.add_edge(file.stem, imp, type="import")
        
        # Step 3: 扫描 method calls（如 userService.generateToken()）
        calls = self._extract_method_calls(file)
        for call in calls:
            if call in self.known_symbols:  # 已知符号表（来自defs + imports）
                graph.add_edge(file.stem, call, type="call")
    
        # Step 4: 注释关键词增强（如 "@auth", "JWT", "OAuth2"）
        comments = self._extract_auth_keywords(file)
        if comments:
            graph.nodes[file.stem]["auth_sensitive"] = True
    
    return graph

注意这个设计的克制：

• 它不 parse AST，所以支持 Java/Python/TS/Go 多语言（只要能提取 import/call 关键词）；
• 它不运行代码，所以安全、快速（万行代码 repo 建图 < 800ms）；
• 它把注释当信号，让 // TODO: refactor to JWT 这种人话也进入图谱——这才是工程师的真实上下文。

当你输入“把登录改成 JWT 方式”，Aider 不是让 LLM 自由发挥，而是：

1. 在 repomap 中查所有 auth_sensitive=True 的文件；
2. 找出它们共同 import/call 的 TokenService、JwtUtil 等节点；
3. 把这些节点和它们的上下游（UserController, SecurityConfig）打包进 context window；
4. 再喂给 LLM：“请基于以下 5 个文件的语义关系，重写登录流程，要求……”。

这叫语义过滤 + 上下文蒸馏，不是“喂全文”，而是“喂关系”。

实战演示：Spring Boot 登录模块 JWT 化（12 分钟实录）

场景：一个搁置半年的 Spring Boot + React demo，登录仍用 Session，需升级为 OAuth2 + JWT + Refresh Token。

Step 1：初始化（带 Git 集成）

## 必须在 git repo 下运行！否则直接退出
$ cd ~/my-spring-demo
$ aider --model sonnet \
  --api-key anthropic=sk-ant-api03-xxx \
  --git \
  --auto-commits \
  --message-format 'conventional'

Step 2：发出指令（Aider 会先确认 scope）

> Please migrate the login flow from session-based to JWT with refresh token rotation.
> Also add Swagger @ApiResponses for 401/403, and write JUnit 5 tests for UserService.login().

Aider 瞬间返回：

I will modify these files:
- src/main/java/com/example/auth/UserController.java
- src/main/java/com/example/auth/UserService.java
- src/main/java/com/example/auth/TokenService.java
- src/main/java/com/example/config/SecurityConfig.java
- src/main/resources/application.yml
- src/test/java/com/example/auth/UserServiceTest.java

Shall I proceed? (Y/n) y

Step 3：原子级修改流（每步都 git add -p）

• 修改 SecurityConfig.java：移除 sessionManagement()，添加 jwtAuthFilter bean → 自动 git add -p → commit refactor(security): replace session auth with JWT filter
• 修改 UserController.login()：注入 TokenService，返回 JwtResponse DTO → git add -p → feat(auth): add JWT response structure
• 生成 RefreshTokenService 并注入到 UserService → 新增文件 → git add -p → feat(auth): implement refresh token rotation

全程你只需按 y/n 确认，git diff 可随时审查，git reset HEAD~3 可一键回滚。

踩坑指南：别被它的“温柔”骗了

• ❌ 别跳过 aider-install：

  bash 复制代码

  # 错误：直接 pip install aider
  pip install aider
  # → ModuleNotFoundError: No module named 'aider.llm'
  
  # 正确：必须用官方 installer（含预编译模型适配器）
  python -m pip install aider-install
  aider-install

• ❌ 别在非 git 目录运行：
  Aider 会静默退出并输出 Hey, I need a git repo to keep things safe. —— 这不是 bug，是设计。它拒绝成为“无版本控制的代码编辑器”。

• ❌ 别对 Java 项目用默认 Python parser：
  Aider 默认用 Python 规则解析，Java 项目需显式指定：

  bash 复制代码

  aider --model deepseek \
    --syntax java \
    --git

  否则 @RestController 可能被当成普通注释忽略。

个人评价：它让我重新相信“工具该长什么样”

Aider 最打动我的，不是它多快或多准，而是它对工程规范的敬畏：

• 它不绕过 Git，而是把 git add -p 变成默认行为；
• 它不屏蔽 diff，而是让你在每次 y 前看到 git diff --no-index；
• 它不承诺“全自动”，而是问“需要我更新 logback-spring.xml 吗？”——把决策权还给你。

这不像 AI 工具，像一个穿格子衬衫、戴黑框眼镜、敲 vim 从不按 Esc 的老同事。他不会替你做架构决定，但会帮你把每个 if 都加好单元测试，把每个 @PostMapping 都补全 Swagger，把每个 TODO 都变成 PR。

如果你还在为重复劳动消耗心神，Aider 不是“值得学”，而是该立刻装上，然后把它设为你的新 git 别名：

alias agit='aider --git --auto-commits'

从此，agit 就是你终端里最安静、最锋利、最守规矩的 co-pilot。

附：今日真实数据

• repo stars: 41,436（2026-03-05）
• repomap 构建耗时（12k 行 Spring Boot 项目）：620ms（Mac M2 Pro）
• 单次 LLM 调用平均 token 数：2,140（context window 严格限制在 4k 内）
• 支持模型：Claude 3.7 Sonnet、DeepSeek R1、OpenAI o3-mini、Ollama llama3:70b（本地离线）