如何移动/集中管理Python项目中的__pycache__文件

方法一：通过环境变量指定缓存目录（Python 3.8+） #

运行Python脚本前设置PYTHONPYCACHEPREFIX环境变量，指向项目根目录的__pycache__文件夹，生成的所有.pyc缓存文件都会统一存放在这里：

• Linux/macOS终端：

  export PYTHONPYCACHEPREFIX="./__pycache__" && python src/main.py
  

• Windows命令提示符（cmd）：

  set PYTHONPYCACHEPREFIX=.\__pycache__ && python src/main.py
  

• Windows PowerShell：

  $env:PYTHONPYCACHEPREFIX = ".\__pycache__"; python src/main.py
  

方法二：通过pyproject.toml配置（Python 3.11+） #

在项目根目录创建pyproject.toml文件，添加以下配置，Python运行时会自动读取并将缓存文件统一放到指定目录：

[tool.python]
pycache-prefix = "./__pycache__"

清理已有的分散__pycache__文件夹 #

完成上述配置后，可以用命令批量删除项目中分散的旧缓存文件夹（保留根目录的__pycache__）：

• Linux/macOS终端：

  find . -type d -name "__pycache__" -not -path "./__pycache__" -exec rm -r {} +
  

• Windows PowerShell：

  Get-ChildItem -Recurse -Directory -Name "__pycache__" | Where-Object { $_ -notlike ".\__pycache__" } | Remove-Item -Recurse -Force
  

内容的提问来源于stack exchange，提问作者Michael Xia