使用指南

运行 aider 并指定你想要编辑的源代码文件。 这些文件会被”添加到聊天会话”中,这样 aider 就能查看它们的 内容并为你进行编辑。 这些文件可以是已存在的文件,也可以是你希望 aider 为你创建的新文件名。

aider <文件1> <文件2> ...

在 aider 的 > 提示符下,请求代码修改,aider 就会编辑这些文件来实现你的需求。

$ aider factorial.py

Aider v0.37.1-dev
模型: 使用 diff 编辑格式的 gpt-4o,弱模型 gpt-3.5-turbo
Git 仓库: .git 包含 258 个文件
仓库映射: 使用 1024 tokens
使用 /help 查看聊天内命令,运行 --help 查看命令行参数
───────────────────────────────────────────────────────────────────────
> 编写一个程序,要求输入数字并打印其阶乘

...

使用 /help <问题>获取关于使用 aider 的帮助, 包括自定义设置、故障排除、使用 LLM 等方面的疑问。

添加文件

要编辑文件,你需要”将它们添加到聊天”中。 可以通过在 aider 命令行中指定文件名来实现。 或者,你也可以使用聊天内的 /add 命令来添加文件。

只添加任务需要编辑的文件。 不要添加一堆无关文件。 如果添加过多文件,LLM 可能会不堪重负 变得混乱(而且会消耗更多 tokens)。 aider 会自动 从相关文件中提取内容,以便 理解代码库的其余部分

你也可以不添加任何文件就使用 aider, 它会根据你的请求尝试判断需要编辑哪些文件。

如果你能考虑清楚哪些文件需要编辑, 只添加这些文件到聊天中,将会获得最佳效果。 aider 会从仓库的其他部分包含相关上下文。

大语言模型

Aider 与 Claude 3.5 Sonnet、DeepSeek R1 & Chat V3、OpenAI o1、o3-mini 和 GPT-4o 配合效果最佳。Aider 可以连接几乎所有大型语言模型,包括本地模型


# o3-mini
$ aider --model o3-mini --api-key openai=<密钥>


# Claude 3.7 Sonnet
$ aider --model sonnet --api-key anthropic=<密钥>

或者你可以运行 aider --model XXX 来启动 aider 并 使用其他模型。 在聊天过程中,你可以使用聊天内的 /model 命令切换模型。

修改代码

您可以要求 aider 对代码进行修改。 aider 会展示它为实现您的需求所做的代码变更差异。 Aider 会将所有变更通过 git commit 提交, 这样便于追踪和撤销修改。

如果对 AI 所做的修改不满意,随时可以使用 /undo 命令撤销。


目录