优先使用 pip config，因其是官方推荐、跨平台一致且自动处理路径与权限；pip.conf 在 Python 3.12 下尤其 Windows 环境易因路径混乱或权限问题失效，而 pip config set global.index-url 可安全全局生效，出错时运行 pip config --edit 自动创建配置目录和文件。
直接改 pip.conf 还是用 pip config？优先选后者
Python 3.12 默认不读取旧版的 pip.conf（尤其在 Windows 上路径混乱、权限易出错），pip config 是官方推荐且跨平台一致的方式。它会自动定位到正确配置文件（Linux/macOS 在 $HOME/.pip/pip.conf，Windows 在 %APPDATA%\pip\pip.ini），避免手写路径错误。
- 执行
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple/即可全局生效 - 想只对当前用户生效（更安全）：把
global换成user - 如果报错
ERROR: Unable to locate configuration file，说明配置目录不存在，先运行pip config --edit让 pip 自动创建目录和空文件
pip install -i 临时换源 vs 配置文件永久换源
临时加 -i 参数适合单次调试或 CI 环境，但容易漏写、难维护；配置文件方式一劳永逸，且不影响 requirements.txt 的语义——只要没显式写 --index-url，就走配置里的源。
- 临时命令：
pip install requests -i https://mirrors.aliyun.com/pypi/simple/ - 注意：临时参数优先级高于配置文件，但不能跳过认证或信任设置（比如用了私有源带证书，
-i不会自动加载--trusted-host） - 若已配置了镜像源，又想某次回退到官方源，得显式加
--index-url https://pypi.org/simple/ --trusted-host pypi.org --trusted-host files.pythonhosted.org
清华、阿里、豆瓣源在 Python 3.12 下的实际差异
三者都支持 HTTPS 和 PEP 508 兼容性，但同步延迟和包完整性略有不同。Python 3.12 新增的 pyproject.toml 构建依赖（如 build、setuptools）对源的元数据响应速度更敏感。
pain-to-pip-package
下载
完整流程：Reddit 痛点扫描 → 聚类 → 构建 pip 可安装的 CLI 工具 → 推送到 GitHub。使用此模式已交付 5 款工具，经验证 343 条痛点。
- 清华源（
https://pypi.tuna.tsinghua.edu.cn/simple/）：同步延迟通常 manylinux 轮子兼容性最好 - 阿里源（
https://mirrors.aliyun.com/pypi/simple/）：偶尔出现404重定向问题，尤其在安装带extras_require的包时 - 豆瓣源（
https://pypi.douban.com/simple/）：已停止维护，Python 3.12 安装numpy或torch时大概率报HTTP 503
验证是否生效 + 常见失效场景
别只看 pip config list 输出，得实际触发一次网络请求才真正确认。常见“看似生效实则没用”的情况集中在缓存和代理上。
立即学习“Python免费学习笔记（深入）”；
- 验证命令：
pip debug -v | grep index-url（显示当前解析出的源地址） - 如果安装时仍走
pypi.org，先清缓存：pip cache purge - 公司内网常配了 HTTP 代理，而镜像源是 HTTPS —— 此时 pip 会 fallback 到默认源，需额外设
pip config set global.trusted-host mirrors.aliyun.com - 虚拟环境里修改的是全局配置，但激活后 pip 实际读的是该环境的
pip可执行文件路径下的配置（极少发生，除非手动改过sysconfig.get_path("purelib")）
pip 却还在连国外源，八成是缓存没清、代理没关、或者 trusted-host 没配全——这三个点比换源本身更容易卡住。 
