pip install 卡在 downloading 是因默认连接境外 pypi 官方源，延迟高、不稳定；解决方法是改用国内镜像源，如清华源（https://pypi.tuna.tsinghua.edu.cn/simple/），支持临时加 -i 参数或永久配置 pip.ini/pip.conf。
pip install 为什么总卡在 downloading？
因为默认走的是 PyPI 官方源 https://pypi.org/simple/，国内直连慢、不稳定，甚至被限速。这不是你网络差，是物理距离和路由策略导致的——官方源服务器在海外，每次下载都要跨太平洋握手。
解决方式不是换网络，而是让 pip 改用国内镜像源，比如清华、中科大、阿里云这些高校或企业维护的同步镜像。它们每 5–10 分钟同步一次 PyPI，内容完全一致，只是访问更快。
临时生效：加 -i 参数最简单
适合单次安装，不改配置，也避免污染全局环境：
- 装包时直接指定镜像：
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple/ - 信任该镜像（防止 HTTPS 重定向警告）：
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple/ --trusted-host pypi.tuna.tsinghua.edu.cn - 中科大源地址是：
https://pypi.mirrors.ustc.edu.cn/simple/；阿里云是：https://mirrors.aliyun.com/pypi/simple/
注意：--trusted-host 在 pip ≥ 21.1 后已默认启用 HTTPS 验证，如果提示证书错误，优先升级 pip：python -m pip install --upgrade pip，而不是盲目加 --trusted-host。
永久生效：写入 pip.conf 或 pip.ini
Linux/macOS 写 ~/.pip/pip.conf，Windows 写 %APPDATA%\pip\pip.ini（路径不存在就手动建目录）。文件里只写三行：
华为云 Python SDK 查询工具。自动发现已安装 SDK 的服务包、Client类、API 方法、入参详情、类信息（__init__ 参数、属性、类型、描述），支持关键字搜索，快速定位目标 API 使用方法。
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple/ trusted-host = pypi.tuna.tsinghua.edu.cn
常见坑：
- Windows 下容易把文件存成
pip.ini.txt（隐藏扩展名），务必关掉“隐藏已知文件类型扩展名”再检查 - 公司内网可能屏蔽了镜像域名，这时要换成内部私有源，或联系 IT 开放
pypi.tuna.tsinghua.edu.cn的出站访问 - 用 Anaconda 或 Miniconda 时，
conda install不走 pip 配置，需单独配 conda 的.condarc
virtualenv 和 poetry 项目里怎么隔离镜像配置？
团队协作或项目依赖敏感时，不能靠全局配置——万一 A 项目必须用私有包索引，B 项目又要走清华源，就会冲突。
推荐做法：
- 在项目根目录放
pip.conf（或pip.ini），然后运行pip install -c pip.conf package，但更常用的是--config-file指定：pip install -c ./pip.conf requests - poetry 用户应在
pyproject.toml里显式声明源：[[tool.poetry.source]] name = "tsinghua" url = "https://pypi.tuna.tsinghua.edu.cn/simple/" secondary = true
并设default = false，避免覆盖私有源 - virtualenv 激活后，
pip config list可查当前生效的配置层级（global / site / user），优先级从高到低
镜像源不是一劳永逸的开关，清华源偶尔同步延迟、阿里云源对某些包做 CDN 缓存，导致 pip install --upgrade 看不到最新版本——遇到这种情况，先 pip install --no-cache-dir，再确认源是否已同步。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
