能否将__pycache__统一生成到集中文件夹？（基于pyproject.toml项目）

__pycache__是Python解释器自动生成的字节码缓存目录，默认随模块分散存放，确实可以通过以下方式统一到你指定的build目录下：

1. 官方推荐：使用PYTHONPYCACHEPREFIX环境变量（Python 3.8+） #

这是最直接的原生解决方案，无需额外依赖：

• 在虚拟环境激活脚本中配置（一劳永逸）：
  • Windows系统：打开虚拟环境目录下的Scripts/activate.bat，添加一行：

    set PYTHONPYCACHEPREFIX=../build/__pycache__
    

  • Linux/macOS系统：打开虚拟环境目录下的bin/activate，添加一行：

    export PYTHONPYCACHEPREFIX="$VIRTUAL_ENV/../build/__pycache__"
    

    下次激活虚拟环境时，Python会自动把所有__pycache__文件生成到指定的build/__pycache__目录下，且会按模块结构生成对应子文件夹，不会混淆不同模块的字节码。
• 临时运行时指定：
  如果不想修改激活脚本，也可以在运行Python命令前临时设置变量：

  PYTHONPYCACHEPREFIX=./build/__pycache__ python your_script.py
  

2. 配合pyproject.toml的间接方案（可选） #

如果希望把配置统一到pyproject.toml中，可以通过自定义脚本实现，但不如环境变量直接：

• 在pyproject.toml中定义一个开发专用脚本，在脚本内部先设置环境变量再执行逻辑：

  [project.scripts]
  dev-start = "your_package.utils:run_with_cache_prefix"
  

  然后在your_package/utils.py中编写：

  import os
  import sys
  from your_package.main import main
  
  def run_with_cache_prefix():
      os.environ["PYTHONPYCACHEPREFIX"] = "./build/__pycache__"
      sys.exit(main())
  

注意事项 #

• 提前手动创建build/__pycache__目录，避免Python因权限问题无法生成：mkdir -p build/__pycache__（Linux/macOS）或md build\__pycache__（Windows）。
• 在.gitignore中添加build/__pycache__/，不要将字节码缓存提交到版本库。
• 可编辑安装模式下，该配置不会影响包的导入逻辑，Python能正常找到对应的字节码文件。

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