是，镜像源没配对是主因；清华源https://pypi.tuna.tsinghua.edu.cn/simple/同步及时、带宽足，而官方源国内直连常卡在10–50 kb/s，配错地址或漏掉/simple/后缀会导致失败。
pip install 时下载慢，是不是镜像源没配对？
不是所有国内镜像都支持完整 PyPI 索引，部分镜像（如清华、中科大、阿里云）同步及时且带宽足，但默认的 https://www.php.cn/link/1921e14349820cc66e19220da2839247/simple/ 在国内直连常卡在 10–50 KB/s。配错地址或漏掉 /simple/ 后缀是常见失败原因。
实操建议：
- 优先用清华源：
https://pypi.tuna.tsinghua.edu.cn/simple/（同步延迟通常 - 避免用已停更或限速的镜像，例如旧版豆瓣源（
http://pypi.douban.com/simple/）近年多次出现 403 或超时 - 临时生效可加
-i参数：pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple/ - 永久配置需写入 pip 配置文件，不同系统路径不同：
~/.pip/pip.conf（Linux/macOS）、%APPDATA%\pip\pip.ini（Windows）
如何验证 pip 是否真的走的是国内镜像？
光看下载速度不保险——有些镜像会 302 跳转回官方源，或者只缓存热门包，冷门包仍回源拉取。得从日志和网络行为确认。
实操建议：
- 加
-v参数触发详细日志：pip install -v flask，观察输出中是否出现你配置的域名（如tuna.tsinghua.edu.cn），而非pypi.org - 用
pip config list查看当前生效的全局/用户级配置，确认global.index-url值正确 - 如果装包时提示
Could not find a version that satisfies...，大概率是镜像未同步该版本，可临时切回官方源验证：pip install -i https://www.php.cn/link/1921e14349820cc66e19220da2839247/simple/ flask==2.3.3
配置了镜像，但 pip search 或 pip install --upgrade 仍慢甚至失败？
pip search 自 2020 年起已弃用（API 下线），任何镜像都无法恢复；而 --upgrade 慢往往是因为 pip 默认会检查所有已安装包的最新版本，逐个向索引源发起 HEAD 请求——哪怕用了镜像，请求量也没减少。
python-docx Skill功能概述python-docx Skill是一项面向实际任务的技能，主要用于本Skill提供使用python-docx生成专业Word文档的标准方法和最佳实践；生成安全服务方案文档；核心要点生成技术架构设计文档；生成任何需要专业排版的Word文档；核心库 : python-docx；使用与执行辅助库 : docx.shared , docx.enum , docx.oxml.ns；标准代码模板；1. 文档初始化；2. 字体设置（必须！它将相关步骤、工具调用和结果整理方式集
实操建议：
- 彻底放弃
pip search，改用pip index versions <code>包名（pip ≥ 21.3）或直接上 pypi.org 网页搜索 - 升级单个包时加
--no-deps减少依赖解析压力，或用pip install -U --upgrade-strategy only-if-needed <code>包名避免盲目升级子依赖 - 某些企业网络会拦截或缓存 302 跳转，导致镜像配置失效，此时可在配置中显式禁用重定向：
trusted-host = pypi.tuna.tsinghua.edu.cn
conda 用户误用 pip 镜像配置，结果两套工具互相干扰？
conda 和 pip 的源完全独立，conda 的 .condarc 里配 pip 镜像毫无作用；反过来，pip 配置也不会影响 conda install。混用时容易误以为“加速了”，其实只是碰巧某个包在 pip 镜像里有缓存、在 conda 渠道里却要重新编译。
实操建议：
- conda 用户应单独配置 conda 镜像，例如清华源：
channels:\n - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/\n - https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/ - 混合环境（conda + pip）中，优先用 conda 安装科学计算类包（numpy、scipy），再用 pip 补充 conda 仓库没有的纯 Python 包（如
black、pre-commit） - 不要在 conda 环境里执行
pip config set global.index-url ...，这会污染其他非 conda 的 Python 环境
镜像配置本身很简单，真正麻烦的是不同工具链的源管理边界、镜像同步滞后性、以及网络中间设备对 HTTP 重定向的处理——这些地方一不留神，下载速度就回到解放前。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
