阿里云仅提供公开PyPI镜像源,不托管私有仓库;需私有化部署pypiserver或devpi。临时使用:pip install -i https://mirrors.aliyun.com/pypi/simple/ pkg;全局配置修改pip.conf或pip.ini;PyCharm需手动添加镜像源并设为默认。

阿里云不提供“私有仓库”地址,只提供公开的 PyPI 镜像源(https://mirrors.aliyun.com/pypi/simple/)。如果你需要的是公司内部可管控、仅限团队访问的私有 PyPI 服务,必须自行搭建(比如用 pypiserver 或 devpi),阿里云本身不托管这类服务。
pip install 时临时指定阿里镜像源
这是最轻量、无副作用的方式,适合 CI/CD 脚本或单次调试。
- 命令格式固定:
pip install -i https://mirrors.aliyun.com/pypi/simple/ some-package - 注意
-i后必须紧跟完整 URL,末尾斜杠不能省略,否则 pip 会报InvalidURL - 如果包依赖中含非纯 Python 的 wheel(如
numpy),建议加--trusted-host mirrors.aliyun.com避免 SSL 验证失败
全局配置 pip 使用阿里镜像(Linux/macOS/Windows)
修改 pip 配置文件后,所有 pip install 命令默认走阿里源,但要注意路径和权限问题。
- Linux/macOS:编辑
~/.pip/pip.conf,写入:[global] index-url = https://mirrors.aliyun.com/pypi/simple/ trusted-host = mirrors.aliyun.com
- Windows:新建或编辑
%USERPROFILE%\pip\pip.ini(不是pip.conf),内容同上 - 若使用虚拟环境且激活后仍不生效,检查是否被
venv自带的pip.conf覆盖,或运行pip config list -v查看实际加载路径
PyCharm 中设置阿里镜像源
PyCharm 的包管理界面(File → Settings → Project → Python Interpreter)默认不读取系统 pip 配置,需手动指定。
- 点击右上角
+添加包时,在搜索框下方点Manage Repositories… - 删掉默认的
https://pypi.org/simple/,新增一行:https://mirrors.aliyun.com/pypi/simple/ - 勾选该地址并设为
Default;若同时添加多个源,PyCharm 会按顺序尝试,第一个命中即停 - 注意:PyCharm 2023.3+ 版本对
trusted-host不再弹窗提醒,但若后台 pip 安装失败,日志里仍会出现 SSL 错误,此时需在该 URL 前加http://(不推荐)或确保系统级 pip 已配好trusted-host
真正需要“私有”语义(鉴权、隔离、上传权限控制)时,https://mirrors.aliyun.com/pypi/simple/ 就不再适用——它本质是公开缓存,任何人都能读。这时候必须用 pypiserver 搭建内网服务,并通过 --passwords 或 htpasswd 文件启用认证,再把 index-url 指向你自己的 http://your-internal-server:8080/simple/。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











