依赖版本管理
Aider 期望安装时所有必需依赖都使用正确的版本。
如果你是通过 GitHub issue 链接跳转到本文档，
或者 aider 正在报告 ImportErrors 错误，
很可能是因为你的 aider 安装使用了不正确的依赖项。
避免包冲突
如果你使用 aider 开发 Python 项目，有时你的项目会需要特定版本的 Python 包， 这些版本可能与 aider 所需的版本冲突。 当这种情况发生时，运行 pip install 时可能会看到如下错误：
aider-chat 0.23.0 需要 somepackage==X.Y.Z，但你安装的是不兼容的 somepackage U.W.V 版本。
使用 aider-install、uv 或 pipx 安装
如果你遇到依赖问题，应该考虑 使用 aider-install、uv 或 pipx 安装 aider。 这将确保 aider 被安装在自己的 Python 环境中， 并使用正确的依赖项集合。
Homebrew、AUR、ports 等包管理器
包管理器通常会使用错误的依赖项安装 aider， 导致导入错误和其他问题。
建议 使用 aider-install、uv 或 pipx 安装 aider。
依赖版本的重要性
Aider 固定了其依赖项版本，并经过测试确保与这些特定版本兼容。 如果你直接使用 pip 安装 aider， 应该谨慎对待升级或降级 aider 使用的 Python 包。
特别要注意 aider 的 requirements.in 文件 末尾标注了固定版本的包。 这些版本被固定是因为已知 aider 无法与这些库的最新版本兼容。
同时也要谨慎升级 litellm，
因为它频繁更新版本，
有时会引入错误或向后不兼容的变更。
Replit 环境
要在 replit 上通过 pipx 使用 aider，可以在 replit shell 中运行以下命令：
pip install pipx
pipx run aider-chat ...normal aider args...
如果在 replit 上通过 pipx 安装 aider 并尝试直接以 aider 命令运行，会因缺少 libstdc++.so.6 库而导致崩溃。