Python安装库临时文件占满磁盘怎么解决

当pip安装大型Python库（如PyTorch或TensorFlow）时，即使磁盘空间充足却报错“No space left on device”，往往是因为系统默认的内存挂载临时目录/tmp（tmpfs）被编译过程产生的海量中间文件迅速占满；通过简单设置环境变量TMPDIR指向一个大容量、高性能的本地目录（如/data/tmp），即可让pip及关联编译工具（gcc、rustc等）将临时文件重定向到该路径，无需root权限或修改系统配置，立竿见影解决卡顿与失败问题——但务必用python -c验证生效，避免因拼写错误、shell配置未加载或IDE环境未继承导致静默回退到原/tmp。

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安装库临时文件占满磁盘怎么解决》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！