如何将Python脚本转为macOS独立应用包与Windows可执行文件并实现后台运行（解决py2app启动报错问题）

Let's tackle your packaging needs step by step, starting with fixing that py2app launch error on macOS, then moving to Windows.

macOS: Resolve py2app Launch Error & Build Background App #

The "Launch Error" you're hitting usually stems from version compatibility between py2app, Python 3.10, and macOS Catalina. Here's how to fix it and build a silent, terminal-free app:

1. Install a py2app version compatible with Python 3.10 & Catalina
   Newer py2app versions can have issues with Catalina. Activate your virtual environment and run:

   pip uninstall -y py2app
   pip install py2app==0.28.6
   

2. Use a custom setup.py to enable background execution
   The default setup from py2applet doesn't include the setting to hide the terminal and Dock icon. Replace your existing setup.py with this:

   from setuptools import setup
   
   APP = ['main.py']
   DATA_FILES = []
   OPTIONS = {
       'argv_emulation': False,
       'plist': {
           'LSUIElement': True,  # Critical: Hides Dock icon and terminal window
           'CFBundleName': 'YourAppName',
           'CFBundleDisplayName': 'YourAppName',
           'CFBundleVersion': '1.0.0'
       },
       'packages': [],  # Add any required third-party packages here if auto-collection fails
   }
   
   setup(
       app=APP,
       data_files=DATA_FILES,
       options={'py2app': OPTIONS},
       setup_requires=['py2app'],
   )
   

3. Clean and rebuild the full app (no alias mode)
   Delete old build artifacts first, then run the full packaging command:

   rm -rf build dist
   python setup.py py2app
   

   The app in the dist folder will now run silently in the background—no terminal window will pop up, and it won't appear in your Dock.

Windows: Build Silent Executable with PyInstaller #

PyInstaller is the most reliable tool for Windows packaging, and it's straightforward to create a console-less executable:

1. Install PyInstaller
   In your Windows virtual environment (or Python setup), run:

   pip install pyinstaller
   

2. Build the silent, single-file executable
   Navigate to your script directory and run:

   pyinstaller --onefile --windowed main.py
   

   • --onefile packages everything into a single .exe file for easy distribution
   • --windowed disables the console window, so the app runs entirely in the background

   Your finished executable will be in the dist folder—double-click it, and it'll run without any visible terminal.

Quick Troubleshooting Tips #

• For py2app launch errors: Check the app's log files for clues. Right-click the app > Show Package Contents > Contents/Logs/python_log.log. This will show missing dependencies or runtime crashes.
• Always package from your activated virtual environment—py2app and PyInstaller only include dependencies installed in the active environment.

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