py2app打包的Python macOS应用仍指向本地路径 无法独立分发

问题根因 #

1. brew安装的Python存在路径硬编码问题 #

brew源Python会将自身site-packages路径硬编码到解释器内核中，py2app打包时会默认优先读取该路径下的依赖，不会主动将第三方库拷贝到应用包内，是导致依赖指向本地路径的核心原因。你使用的Python3.6版本过旧，对应版本的py2app也存在依赖识别逻辑bug，会跳过site-packages.zip生成步骤。

2. setup.py配置缺失 #

仅在命令行传递--packages参数优先级低于setup.py内部的配置项，若setup.py未声明完整的py2app打包规则，会触发依赖跳过逻辑，不会生成打包后的依赖归档。

3. 参数遗漏 #

你传递的--packages参数仅包含paramiko、yaml、scp，缺失PyQt5依赖，也会导致部分依赖识别异常。

解决方案 #

• 更换Python环境：优先使用Python官方提供的pkg安装包安装Python3.8及以上版本，避免brew版本的路径硬编码问题。如果必须使用当前Python3.6环境，先执行pip3 install -U py2app升级到对应版本的最新py2app。
• 编写完整的setup.py配置，示例如下：

from setuptools import setup

# 替换为你的应用入口脚本路径
APP = ['main.py']
DATA_FILES = []
OPTIONS = {
    # 声明所有需要打包的第三方依赖包
    'packages': ['paramiko', 'scp', 'yaml', 'PyQt5'],
    'includes': ['paramiko', 'scp', 'yaml', 'PyQt5'],
    # 强制所有依赖打包进site-packages.zip
    'zip_include_packages': ['*'],
    'zip_exclude_packages': [],
    # PyQt5应用需关闭argv模拟避免启动异常
    'argv_emulation': False,
}

setup(
    app=APP,
    data_files=DATA_FILES,
    options={'py2app': OPTIONS},
    setup_requires=['py2app'],
)

• 打包前清空旧缓存，避免历史构建文件干扰：rm -rf build dist __pycache__
• 直接执行python3 setup.py py2app完成打包，无需额外传递--packages参数。

打包完成后检查dist/testapp.app/Contents/Resources/lib/python<版本号>/目录下是否存在site-packages.zip，运行包内Python执行import paramiko; print(paramiko.__path__)，路径会指向应用包内的zip归档路径，应用可正常分发到其他设备运行。

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