1. 安装 Aider

Aider 提供多种安装方式，适用于不同操作系统和用户需求。以下是详细的安装步骤：

1.1 使用 aider-install（推荐）

适用场景：已安装 Python 3.8-3.13 的系统，自动管理独立环境。
步骤：

1. 安装 aider-install 工具：

   python -m pip install aider-install
   

2. 运行安装命令，Aider 会自动创建独立 Python 环境（必要时安装 Python 3.12）：

   aider-install
   

3. 安装完成后，即可通过 aider 命令启动。

1.2 一键安装脚本

适用场景：快速安装，自动处理 Python 依赖（推荐新手使用）。

Mac & Linux

使用 curl 或 wget 执行安装脚本：

# 使用 curl
curl -LsSf https://aider.chat/install.sh | sh

# 若系统无 curl，使用 wget
wget -qO- https://aider.chat/install.sh | sh

Windows

在 PowerShell 中执行：

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"

1.3 使用 uv 安装

适用场景：需要高效依赖管理的用户，uv 是快速的 Python 包管理器。

1. 安装 uv（若未安装）：

   python -m pip install uv
   

2. 使用 uv 安装 Aider，指定 Python 3.12：

   uv tool install --force --python python3.12 --with pip aider-chat@latest
   

   注：uv 会自动安装 Python 3.12（若系统未安装）。

1.4 使用 pipx 安装

适用场景：希望隔离应用环境的用户，pipx 专为 CLI 工具设计。

1. 安装 pipx（若未安装）：

   python -m pip install pipx
   

2. 安装 Aider（支持 Python 3.9-3.12）：

   pipx install aider-chat
   

1.5 使用 pip 安装（需虚拟环境）

适用场景：熟悉 Python 虚拟环境的用户，需手动管理依赖隔离。

1. 创建并激活虚拟环境（以 Python 3.12 为例）：

   python3.12 -m venv aider-venv
   source aider-venv/bin/activate  # Linux/Mac
   # 或 Windows: aider-venv\Scripts\activate
   

2. 安装 Aider：

   python -m pip install -U --upgrade-strategy only-if-needed aider-chat
   

   注意：若提示 aider: command not found，可尝试 python -m aider 启动。

2. Docker 部署 Aider

Aider 提供 Docker 镜像，适合容器化部署，支持核心版和完整版两种镜像。

2.1 核心版镜像（paulgauthier/aider）

特点：轻量，包含基础功能，首次使用可选功能需额外安装。

1. 拉取镜像：

   docker pull paulgauthier/aider
   

2. 运行容器（需映射项目目录和 API 密钥）：

   docker run -it --user $(id -u):$(id -g) --volume $(pwd):/app paulgauthier/aider \
     --openai-api-key $OPENAI_API_KEY [...其他参数...]
   

2.2 完整版镜像（paulgauthier/aider-full）

特点：预装所有可选功能（如浏览器 GUI、Playwright 网页抓取）。

1. 拉取镜像：

   docker pull paulgauthier/aider-full
   

2. 运行容器：

   docker run -it --user $(id -u):$(id -g) --volume $(pwd):/app paulgauthier/aider-full \
     --openai-api-key $OPENAI_API_KEY [...其他参数...]
   

2.3 Docker 部署注意事项

• 项目目录映射：需在项目根目录运行命令，确保 --volume $(pwd):/app 正确映射本地代码库。
• Git 配置：容器内无全局 Git 配置，需在项目中手动设置用户信息：

  git config user.email "you@example.com"
  git config user.name "Your Name"
  

• 功能限制：/voice 命令需宿主机音频设备权限，/run 命令在容器内执行（可能与本地环境不一致）。

3. 基本使用指南

3.1 启动 Aider 并添加文件

1. 指定文件启动：直接在命令行列出需编辑的文件（推荐仅添加必要文件，避免上下文过载）：

   aider factorial.py  # 启动并添加 factorial.py
   

2. 动态添加文件：启动后使用 /add 命令添加文件：

   > /add utils.py main.py  # 添加 utils.py 和 main.py 到当前会话
   

3.2 选择和切换模型

Aider 支持多种 LLM（如 OpenAI、Anthropic、DeepSeek 等），需通过 API 密钥认证。

• 启动时指定模型：

  # OpenAI o3-mini
  aider --model o3-mini --api-key openai=<your-key>
  
  # Claude 3.7 Sonnet
  aider --model sonnet --api-key anthropic=<your-key>
  

• 会话中切换模型：使用 /model 命令：

  > /model deepseek  # 切换到 DeepSeek 模型
  

3.3 与 Aider 交互

1. 输入请求：在 > 提示符后输入自然语言指令，例如：

   > 编写一个计算阶乘的函数，处理非负整数输入
   

2. 查看更改：Aider 会生成代码 diff 并自动提交到 Git，便于追踪和回滚。
3. 撤销更改：使用 /undo 命令撤销上一次 AI 提交：

   > /undo  # 撤销最近一次更改
   

3.4 多行消息输入

发送长文本或代码块时，可使用以下方法：

• 标签包裹：以 {tag 开头，tag} 结尾（支持包含 } 字符）：

  > {python
  def hello():
      print("Hello}")  # 包含右括号
  python}
  

• 多行模式：用 /multiline-mode 切换，使 Enter 键换行，Meta+Enter 提交。
• 编辑器输入：使用 /editor 命令打开系统编辑器编写消息。

4. 常用命令参考

Aider 支持丰富的斜杠命令，以下是核心功能命令表：

命令	描述
/add <文件>	添加文件到会话，供 AI 编辑或查看
/model <模型>	切换 LLM 模型（如 sonnet、o3-mini）
/undo	撤销上一次 AI 提交的更改
/run <命令>	在容器内执行 shell 命令（结果可添加到聊天）
/diff	显示自上次消息以来的代码更改
/clear	清除聊天历史
/help <问题>	询问 Aider 使用帮助、配置或故障排除
/voice	录制语音输入并转录为文本（需音频设备支持）
/web <URL>	抓取网页内容并转换为 Markdown 添加到聊天

*完整命令列表可通过 /help