pip install报错“oserror: [errno 28] no space left on device”但磁盘仍有空间，实为/tmp（常为tmpfs）被临时文件占满；通过设置tmpdir指向大容量本地目录可绕过该限制，需验证python -c "import tempfile; print(tempfile.gettempdir())"确认生效。
pip install 时 /tmp 目录爆满的典型表现
执行 pip install 大型包（如 torch、tensorflow、pyarrow）时卡住，报错类似 OSError: [Errno 28] No space left on device，但 df -h 显示磁盘还有大量空间——这大概率是系统默认的 /tmp 分区（常为内存挂载的 tmpfs）被 pip 解压和编译过程产生的临时文件塞满了。
为什么改 TMPDIR 能解决问题
pip 在构建源码包（尤其是含 C 扩展的包）时，会把 .tar.gz 解压到临时目录，再调用 setup.py 或 pyproject.toml 构建流程，中间生成的 build/、__pycache__/、.eggs/ 等目录可能高达数 GB。这些路径默认由 Python 的 tempfile.gettempdir() 决定，而它优先读取环境变量 TMPDIR（不是 TMP 或 TEMP）。
-
TMPDIR是 Unix/Linux/macOS 下标准的临时目录控制变量，Python、gcc、cmake 等工具都认它 - Windows 下 pip 也支持
TMPDIR，但更常用TEMP；不过统一设TMPDIR可覆盖多数场景 - 不修改系统级
/tmp挂载参数，也不需要 root 权限，纯用户态生效
三种可靠设置 TMPDIR 的方式（按推荐顺序）
确保所有 pip 子进程（包括调用的 gcc、rustc、meson 等）都能继承该变量：
- 终端当前会话生效：运行
export TMPDIR="/path/to/large/partition/tmp"，再执行pip install - 写入 shell 配置（如
~/.bashrc或~/.zshrc）：添加export TMPDIR="/data/tmp"，然后source ~/.zshrc - 单次命令覆盖：直接
TMPDIR="/data/tmp" pip install torch—— 这种写法最安全，不影响其他命令
注意：/path/to/large/partition/tmp 必须存在且当前用户有读写权限；建议提前 mkdir -p /data/tmp && chmod 700 /data/tmp。不要指向 NFS 或慢速网络盘，否则编译速度会显著下降。
验证是否生效及常见失效原因
执行 python -c "import tempfile; print(tempfile.gettempdir())"，输出应与你设置的 TMPDIR 一致。如果没变，检查以下几点：
- 拼写错误：
TMPDIR不是TEMPDIR、TMP_DIR或TEMP - shell 配置未重载：改完
.zshrc后忘记source，或新开终端没读配置 - IDE 或 notebook 环境未继承：PyCharm/Jupyter 默认不加载 shell 配置，需在设置里显式指定环境变量，或改用命令行安装
- 某些 CI 环境（如 GitHub Actions）需在
env:块中单独声明TMPDIR，不能只靠 setup script
临时目录路径一旦设错，pip 可能静默 fallback 到系统 /tmp，不会报错提示——所以务必用 python -c 验证，别只信“我明明设置了”。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
