Python 软件包索引仓库使用帮助

PyPI 介绍

PyPI（The Python Package Index）是 Python 编程语言的软件存储仓库。其托管在 https://pypi.org/ 上。

caution

pip 工具默认配置下仅支持 https, 请不要使用 http。

关于externally-managed-environment 错误

Python 3.11 中实现了 PEP 668，允许 Python 软件包指定默认情况下是否可以在全局解释器上下文中安装包。如果遇到该问题，可以尝试使用 venv 创建虚拟环境，或者使用其他基于虚拟环境的的包管理器。

pip install -i https://mirrors.hust.edu.cn/pypi/web/simple <some-package>

pip config set global.index-url https://mirrors.hust.edu.cn/pypi/web/simple

caution

请升级 pip 到 10 以上版本后进行配置。

如果 pip 版本较低，可以使用下面的命令升级 pip

python -m pip install -i https://mirrors.hust.edu.cn/pypi/web/simple --upgrade pip

PDM 支持使用 pdm config 命令或环境变量来设置软件镜像。如果长期使用，建议通过 pdm config 进行配置。

使用 pdm config 命令设置软件镜像：

pdm config pypi.url https://mirrors.hust.edu.cn/pypi/web/simple

或使用环境变量设置 PDM 软件镜像：

export PDM_PYPI_URL=https://mirrors.hust.edu.cn/pypi/web/simple

caution

Poetry 不支持配置全局镜像，只能为项目配置。

Poetry 支持使用 poetry source 命令或修改 pyproject.toml 来设置当前项目的软件镜像。

使用 poetry source 命令设置软件镜像：

poetry source add --priority=primary mirrors https://mirrors.hust.edu.cn/pypi/web/simple

或修改 pyproject.toml 设置软件镜像，在 pyproject.toml 文件中添加如下内容：

[[tool.poetry.source]]
name = "mirrors"
url = "https://mirrors.hust.edu.cn/pypi/web/simple"
priority = "primary"

pipx 默认使用和 pip 相同的镜像，故设置软件镜像的方式与 pip 相同。

如果希望使用官方默认镜像，请将以上命令中的镜像地址改为 https://pypi.org/simple，使用同样的方式进行配置即可。