windows下pip.ini必须置于%appdata%pippip.ini，否则不读取；需用utf-8无bom编码保存，最小配置为[global]和index-url=https://pypi.tuna.tsinghua.edu.cn/simple/。
Windows 下 pip.ini 配置文件必须放在 %APPDATA%pippip.ini（即 C:Users\AppDataRoamingpippip.ini），否则 pip 完全不读取 —— 这是绝大多数人配置失败的根源。
pip.ini 文件路径和创建方式
pip 在 Windows 上只认两个位置的配置文件，按优先级从高到低：
-
%APPDATA%pippip.ini（用户级，推荐）：路径等价于C:Users\AppDataRoamingpippip.ini，无需管理员权限，只影响当前用户 -
C:ProgramDatapippip.ini（全局级）：需管理员权限写入，影响所有用户，但多数场景没必要动
常见错误：
- 把文件放在
C:Users\pippip.ini—— 这个路径 pip 根本不扫描，哪怕目录存在、文件存在、内容正确，也完全无效 - 用记事本保存时默认编码为 ANSI 或 GBK，导致中文注释或 URL 解析失败；必须用 UTF-8 无 BOM 编码保存
- 文件扩展名是
pip.ini.txt（系统隐藏了扩展名），实际不是 ini 文件
pip.ini 的最小可用配置内容
一个能生效的最简配置只需两行，写在 %APPDATA%pippip.ini 中即可：
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple/
注意：
Ai Podcast Pipeline
下载
从QuickView趋势笔记生成韩语AI播客包，含双人主持脚本（Callie×Nick）、Gemini多说话人TTS音频、字幕时间轴与渲染修正、缩略图+MP4包装及YouTube标题/描述输出。支持完整版（15~20分钟）和压缩版（5~7分钟）。
-
index-url值末尾的/simple/不能省，少斜杠会报404 Client Error - 必须用
https，http地址（如旧教程里的http://pypi.tuna.tsinghua.edu.cn/simple）在 pip ≥ 21.0 后默认被拒绝 - 如果要用阿里云源，写成：
index-url = https://mirrors.aliyun.com/pypi/simple/ - 不需要手动加
[install]段落或trusted-host—— pip ≥ 20.3 会自动信任主流 HTTPS 镜像域名
验证配置是否真正生效
别信“改完就 OK”，必须运行命令确认：
- 执行
pip config list -v：输出里出现for user path: C:Users...AppDataRoamingpippip.ini才说明路径对了 - 执行
pip install -v requests（加-v）：看日志第一行是否显示Using cached ... from https://pypi.tuna.tsinghua.edu.cn/... - 如果仍走
files.pythonhosted.org，说明配置没加载，大概率是路径或编码错了
特别注意：pip config set global.index-url ... 命令在某些 pip 版本（尤其是旧版或被系统策略限制的环境）下会静默失败，且生成的配置文件路径可能不标准 —— 直接编辑 %APPDATA%pippip.ini 是最可控的方式。
虚拟环境中要不要单独配 pip.ini？
一般不用。虚拟环境激活后，默认继承用户级配置（即 %APPDATA%pippip.ini）。只有当你需要某个项目强制走特定源（比如内部私有源），才在虚拟环境根目录下放一个 pip.ini，路径类似：myproject envpip.ini。但要注意：
- 这个文件只在该虚拟环境激活时生效
- 它不会覆盖用户配置里的
index-url，而是直接替换 —— 如果你同时在用户级和虚拟环境级都写了index-url，以虚拟环境级为准 - Ubuntu/Debian 系统上若启用了 PEP 668（如 Ubuntu 24.04+），系统级 pip 被锁定，此时用户级 pip.ini 依然有效，但必须配合
python3 -m pip使用
路径、编码、协议这三处细节错任何一处，pip 就当配置不存在 —— 它不会报错，只会默默回退到官方源。
