设置 pip_no_cache_dir=1 是最直接有效的方式，因为它让 pip 完全跳过缓存逻辑、不创建缓存目录，且作为环境变量可在 ci 配置中全局生效，优先级高于 pip_cache_dir。
为什么设置 PIP_NO_CACHE_DIR=1 是最直接有效的方式
CI/CD 环境中 pip 默认会在 ~/.cache/pip 下缓存下载的 wheel 和源码包，反复构建时会不断累积，尤其在无状态容器或临时 runner 上，这些缓存不仅浪费磁盘空间，还可能因过期导致依赖解析不一致。禁用缓存最轻量、最可靠的方法就是让 pip 完全跳过缓存逻辑——PIP_NO_CACHE_DIR=1 正是为此设计的环境变量，它会让 pip 把所有缓存操作视为空操作，连目录都不尝试创建。
注意：它和 --no-cache-dir 命令行参数等价，但作为环境变量更易在 CI 配置（如 GitHub Actions 的 env:、GitLab CI 的 variables:）中全局生效，避免漏掉某个 pip install 调用。
-
PIP_NO_CACHE_DIR=1优先级高于PIP_CACHE_DIR，即使后者已设，前者仍强制禁用 - 它不影响
--find-links或--index-url行为，只关闭本地缓存读写 - 某些旧版 pip（pip install --upgrade pip
在 GitHub Actions 中安全启用的典型写法
GitHub Actions 的 job 级 env 设置会透传给所有 step，但要注意 shell 类型和执行时机——尤其是用 run: 执行多行命令时，环境变量需显式导出或用 shell: bash -e {0} 保证生效。
env:
PIP_NO_CACHE_DIR: "1"
PIP_DISABLE_PIP_VERSION_CHECK: "1"
steps:
- uses: actions/setup-python@v4
- run: |
python -m pip install --upgrade pip
pip install -r requirements.txt
shell: bash -e {0}
这里额外加了 PIP_DISABLE_PIP_VERSION_CHECK=1，因为版本检查本身会触发少量临时网络请求和缓存试探行为，禁用后更干净。如果使用 run: pip install ... 单行写法，无需 shell: 配置也能继承 env。
完整流程：Reddit 痛点扫描 → 聚类 → 构建 pip 可安装的 CLI 工具 → 推送到 GitHub。使用此模式已交付 5 款工具，经验证 343 条痛点。
误用 PIP_CACHE_DIR=/dev/null 会导致 pip 报错
有人试图通过把缓存目录指向 /dev/null 来“清空”缓存，例如设置 PIP_CACHE_DIR=/dev/null。这在大多数 Linux 系统上会触发 pip 内部的路径合法性检查失败，报错类似：
ERROR: Invalid cache directory /dev/null given. Cache directories must be directories.
因为 pip 在初始化缓存前会调用 os.path.isdir() 检查路径，而 /dev/null 是设备文件，不是目录。同理，指向不存在的路径（如 /tmp/nonexistent）也会让 pip 尝试创建目录失败，转而回退到默认缓存路径，实际未禁用。
- 绝对不要用
PIP_CACHE_DIR配合非法路径来“绕过”缓存 - 若需临时清理已有缓存，应单独执行
pip cache purge，而非靠环境变量“欺骗” -
PIP_NO_CACHE_DIR=1是唯一被 pip 官方文档明确支持的禁用方式
PyPI 镜像源 + 禁用缓存仍可能产生临时解压目录
禁用 pip 缓存后，wheel 包仍需在安装过程中临时解压（例如 pip install some-package 会把 wheel 解到 /tmp/pip-xxx）。这部分不由 PIP_NO_CACHE_DIR 控制，且通常由系统 TMPDIR 决定位置。在磁盘紧张的 CI 环境中，可配合：
- 设置
TMPDIR: /tmp（确保有足够空间）或TMPDIR: /dev/shm（内存文件系统，适合小包） - 对纯二进制 wheel 使用
--only-binary=:all:减少编译期临时文件 - 避免
pip install .或pip install -e .，它们会触发源码构建，生成大量中间文件
真正节省空间的关键，是让 pip 不写持久缓存，同时控制好临时文件生命周期——这两者必须分开处理，不能指望一个环境变量解决全部问题。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
