常见命令与报错处理
这一页用于快速查找 Aider 常用命令和 Xikapi 接入问题。
常用命令
| 目标 | 命令 |
|---|---|
| 查看帮助 | aider --help |
| 指定模型启动 | aider --model openai/YOUR_MODEL_ID |
| 添加文件 | /add <file> |
| 查看 diff | /diff |
| 撤销上次改动 | /undo |
| 查看会话帮助 | /help |
连接不到 Xikapi
检查:
bash
echo $OPENAI_API_BASE
echo $OPENAI_API_KEYWindows PowerShell:
powershell
$env:OPENAI_API_BASE
$env:OPENAI_API_KEYOPENAI_API_BASE 应为:
text
https://xikapi.com/v1Model Not Found
检查:
- 启动命令是否写成
aider --model openai/模型名。 - 模型名是否在 Xikapi 后台启用。
- 当前 Xikapi API Key 是否有该模型权限。
模型未知或 warning
Aider 对不熟悉的模型可能给出 warning。只要 Xikapi 返回正常,并且模型支持当前任务,可以继续使用;如果编辑效果不稳定,换用更适合代码编辑的模型。
成本偏高
- 只添加必要文件。
- 避免让 Aider 反复读取大型文件。
- 小任务用低成本模型。
- 大型重构先让它写计划,再分批执行。
改坏了怎么办
优先使用:
text
/undo如果已经退出 Aider,使用 Git 查看和回退你确认不要的改动。不要在不清楚影响范围时直接重置整个仓库。