Mac环境下通过Homebrew安装Python运行PyBuilder报虚拟环境兼容及可执行文件失效错误求助

报错核心原因 #

• Homebrew 安装的 Python 默认将自身框架路径指向 /usr/local/Cellar/ 下的安装目录，PyBuilder 自动在项目下创建插件运行专用的 .pybuilder 虚拟环境时，会错误复用系统 Python 的路径配置，和插件虚拟环境的实际路径不匹配，直接触发兼容性校验报错。

分步操作流程 #

• 清理项目下生成的无效 .pybuilder 虚拟环境缓存：
  rm -rf .pybuilder
• 核对当前激活的项目虚拟环境路径：
  执行 which python，输出必须为项目下 venv/bin/python 的路径，若输出为 Homebrew 的 Python 路径，重新执行 source venv/bin/activate 激活项目虚拟环境。
• 执行构建时显式指定当前虚拟环境的 Python 解释器路径，避免 PyBuilder 自动探测到系统 Homebrew Python：
  pyb --verbose --python=$(which python)
• 若仍出现路径不匹配报错，可在项目根目录的 build.py 配置中固定解释器路径，避免自动探测异常：

  import sys
  from pybuilder.core import use_plugin, init
  
  use_plugin("python.core")
  @init
  def initialize(project):
      project.set_property("python_interpreter", sys.executable)
  

• 配置完成后重新执行 pyb，即可正常完成项目构建。

补充注意事项 #

• 全程不要在全局 Python 环境下安装、运行 PyBuilder，所有操作都在项目 venv 激活状态下执行，避免路径耦合。
• 若使用 Homebrew 安装的 Python 3.10 及以上版本，需确保安装的 PyBuilder 版本不低于 0.13.0，旧版本对新版 Homebrew Python 的路径适配存在已知问题。

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