DevContainer中pip镜像源必须显式注入，postCreateCommand写入/etc/pip.conf.d/最可靠；Dockerfile中固化配置更彻底；containerEnv设PIP_INDEX_URL兼容性差且不控trusted-host。
DevContainer 中 Python 的 pip 镜像源不会自动继承宿主机配置，必须显式注入；否则 pip install 默认走官方源，国内用户大概率超时或卡死。
devcontainer.json 里用 postCreateCommand 注入镜像源最可靠
这是最直接、最可控的方式：容器创建后立即执行命令，覆盖全局 pip 配置。注意它只在首次构建时运行一次，且必须返回 exit code 0，否则容器标记为“创建失败”。
- 推荐写法（适配 Debian/Ubuntu 基础镜像）：
"postCreateCommand": "mkdir -p /etc/pip.conf.d && echo '[global]\nindex-url = https://pypi.tuna.tsinghua.edu.cn/simple/\n[install]\ntrusted-host = pypi.tuna.tsinghua.edu.cn' > /etc/pip.conf.d/01-mirror.conf"
- 若用 Alpine 镜像，路径要改成
/etc/apk/repositories不适用，仍用/etc/pip.conf.d/（pip 自身支持） - 避免用
pip config set global.index-url ...—— 容器内常无pip用户配置目录，且该命令依赖~/.pip/pip.conf，而remoteUser未设时默认是root，~可能未初始化
containerEnv 无法让 pip 读取镜像源
containerEnv 只能设置环境变量，比如 PIP_INDEX_URL，但 pip 默认不认这个变量 —— 它只响应 PIP_INDEX_URL 在某些版本中有效，但兼容性差，且不控制 trusted-host，容易因 SSL 验证失败中断。
- 实测行为：设
"containerEnv": { "PIP_INDEX_URL": "https://pypi.tuna.tsinghua.edu.cn/simple/" }后，pip install requests仍可能报CertificateError - 真正生效的环境变量是
PIP_TRUSTED_HOST，但必须和PIP_INDEX_URL同时存在，且版本 >= 21.1 才稳定支持 - 不如直接写配置文件一劳永逸，不依赖 pip 版本
Dockerfile 里提前写死镜像源更彻底
如果用自定义 Dockerfile 构建镜像，把 pip 镜像源固化进镜像层，后续所有基于该镜像的容器都自带加速能力，也避免每次 postCreateCommand 重复写文件。
立即学习“Python免费学习笔记（深入）”；
- 在
RUN pip install ...前加一行：RUN mkdir -p /etc/pip.conf.d && \ echo '[global]\nindex-url = https://mirrors.aliyun.com/pypi/simple/\n[install]\ntrusted-host = mirrors.aliyun.com' > /etc/pip.conf.d/01-mirror.conf - 注意：Docker 构建阶段的
RUN是 root 权限，路径安全；但不要用pip config命令，因为构建缓存中 pip 可能没装全 - 镜像一旦推送到私有 registry，团队其他成员拉取即用，无需再改任何配置
真正容易被忽略的是：即使你用了清华源，在 DevContainer 中第一次 pip install 仍可能慢——因为 pip 的 wheel 缓存目录（/root/.cache/pip）默认不在容器 volume 中，每次重建都清空。如需复用缓存，得用 mounts 显式绑定宿主机路径，否则提速效果会打折扣。
