问题分析 #

从你给出的错误日志来看，核心问题是PYTHONHOME环境变量被错误设置了——Platypus封装App时，把PYTHONHOME指向了App的Resources目录，但PyInstaller打包出来的可执行文件本身已经包含了完整的Python运行环境，不需要外部指定PYTHONHOME，这就导致Python找不到核心的encodings模块，直接触发了致命错误。

解决方案一：修复Platypus的启动脚本 #

你之前尝试unset变量没生效，大概率是脚本的执行时机或者Platypus的默认环境设置问题，按下面的步骤调整：

1. 新建一个Shell脚本（比如start_app.sh），内容如下：

#!/bin/bash
# 彻底清除可能干扰的Python环境变量
unset PYTHONHOME
unset PYTHONPATH
# 切换到可执行文件所在的目录（避免路径依赖问题）
cd "$(dirname "$0")"
# 启动PyInstaller生成的可执行文件
./PageDownloader

2. 在Platypus中配置：

   • 把“Script”选项切换成这个新的start_app.sh
   • 检查“Environment Variables”面板，确保没有任何PYTHON相关的变量被手动添加
   • 保存配置后重新生成App，双击测试

3. 先手动验证脚本：在终端里cd到Resources目录，运行./start_app.sh，确认程序能正常启动，再封装成App。

解决方案二：用PyInstaller直接生成Mac App（更推荐） #

其实你完全不需要用Platypus，PyInstaller本身就支持直接生成标准的Mac .app包，步骤更简单，兼容性更好：

1. 确保你在虚拟环境ambiente中：

source ambiente/bin/activate

2. 安装PyInstaller（如果没装的话）：

pip install pyinstaller

3. 执行打包命令：

   • 如果你的程序是GUI应用（不需要终端窗口）：

     pyinstaller --onefile --windowed --name PageDownloader PageDownloader.py
     

   • 如果是命令行应用（需要弹出终端窗口）：

     pyinstaller --onefile --name PageDownloader PageDownloader.py
     

4. 打包完成后，在项目根目录的dist文件夹里就能找到PageDownloader.app，这个App是完全独立的，双击就能运行，也可以直接分享给其他Mac用户。

额外注意事项 #

• 打包时尽量保持虚拟环境干净：只安装项目必需的依赖，避免打包多余文件，减小App体积
• 跨架构兼容：如果你的Mac是Intel芯片，要给M系列芯片用户分发的话，建议用universal2版本的Python（Python 3.9+支持）打包，生成兼容两种架构的App
• 签名与分发：如果要避免Mac的Gatekeeper拦截，需要用苹果开发者证书给App签名，具体可以参考苹果的官方文档

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