当前位置：首页 > news >正文

如何在ubuntu下用pip安装aider，解决各种报错问题

news 2025/9/16 6:15:15

aider中文文档网站上给出的安装说明比较简单：

https://aider.doczh.com/docs/install.html

但是在一个干净的ubuntu环境中按文档中的命令安装时，会报错，经过一番尝试之后，解决了报错问题，成功完成了安装。

成功安装执行的命令如下，大家可以直接取用（注意，新版本的ubuntu上默认安装的是python3，而非python，所以下面命令中都是用的python3）：

sudo apt install python3-pip python3.12-venvpython3 -m venv myenvsource myenv/bin/activatepip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simplepip install aider-installUV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple aider-install

下面是问题的解决过程，大家感兴趣的话可以参考一下，不感兴趣可以直接忽略。

按aider中文文档中的说明执行命令：

python3 -m pip install aider-install

报错：

/usr/bin/python3: No module named pip

很明显，是说缺少pip模块。但是用

sudo apt install python3-pip

命令安装了pip后，运行前面的命令依然报错，这次报的是：

error: externally-managed-environment× This environment is externally managed
╰─> To install Python packages system-wide, try apt installpython3-xyz, where xyz is the package you are trying toinstall.If you wish to install a non-Debian-packaged Python package,create a virtual environment using python3 -m venv path/to/venv.Then use path/to/venv/bin/python and path/to/venv/bin/pip. Makesure you have python3-full installed.If you wish to install a non-Debian packaged Python application,it may be easiest to use pipx install xyz, which will manage avirtual environment for you. Make sure you have pipx installed.See /usr/share/doc/python3.12/README.venv for more information.note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
hint: See PEP 668 for the detailed specification.

是说需要在虚拟环境中安装python包。

于是执行创建虚拟环境的命令：

python3 -m venv myenv

又报错了：

The virtual environment was not created successfully because ensurepip is not
available.  On Debian/Ubuntu systems, you need to install the python3-venv
package using the following command.apt install python3.12-venvYou may need to use sudo with that command.  After installing the python3-venv
package, recreate your virtual environment.Failing command: /home/teratech/erule-web-3.0/myenv/bin/python3

是说venv模块没有安装，于是再运行

apt install python3.12-venv

命令安装venv。

安装完成后，再次运行

python3 -m venv myenv

命令，虚拟环境创建成功。

然后引用虚拟环境：

source myenv/bin/activate

引用后，命令提示符前出现 (myenv) 标识，说明已经进入了虚拟环境。

更换pip镜像源（重要‼️，否则后续安装aider-install和用aider-install安装aider时会报超时错误）：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

这时再执行安装aider的命令：

pip install aider-install

安装 aider-install 成功：

Collecting aider-installDownloading aider_install-0.2.0-py3-none-any.whl.metadata (2.0 kB)
Collecting uv>=0.5.0 (from aider-install)Downloading uv-0.8.15-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.metadata (11 kB)
Downloading aider_install-0.2.0-py3-none-any.whl (6.9 kB)
Downloading uv-0.8.15-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (21.0 MB)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 21.0/21.0 MB 15.5 kB/s eta 0:00:00
Installing collected packages: uv, aider-install
Successfully installed aider-install-0.2.0 uv-0.8.15

然后运行：

UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple aider-install

命令，并最终安装成功:

Installed 1 executable: aider

注意：UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple 一定要加，因为aider-install命令内部是使用的是uv工具（Ultra-Violet）进行安装，而非直接调用pip。因此即使我们前面已经配置了pip的清华源，该命令仍会使用uv默认的下载通道，导致超时问题。

安装完成后，需要运行一下更新shell的命令：

. ~/.bashrc

来让 .local/bin 目录被加到 PATH 中，从而让 aider 命令能被找到。

更新完shell后，运行 aider 命令，就可以使用aider了：

~$ aider
────────────────────────────────────────────────────────────────────────────────
Aider respects your privacy and never collects your code, chat messages, keys orpersonal info.
For more info: https://aider.chat/docs/more/analytics.html
Allow collection of anonymous analytics to help improve aider? (Y)es/(N)o [Yes]: