跨平台编译Python脚本为Windows可运行程序求助

Hey there! Let's work through this—first, a quick note on why your initial attempts ran into issues: PyInstaller is platform-specific, so builds from Mac will never run on Windows, and you always need to package on the target OS (Windows, in this case). Let's cover both fixes for your Windows PyInstaller error, plus alternative options that don't require an EXE.

Fix the Windows PyInstaller "failed to execute script" error #

This is usually caused by missing dependencies, path issues, or a dirty environment. Try these steps:

• First, create a clean virtual environment on Windows to avoid conflicting packages:

  python -m venv win_env
  win_env\Scripts\activate  # Activate the environment
  pip install your-dependency-1 your-dependency-2  # Install your exact libraries
  pip install pyinstaller
  

• Use a basic one-file build command to start:

  pyinstaller --onefile your_script.py
  

• If you still get an error, check the traceback—often it's a hidden import that PyInstaller missed. Add it explicitly with --hidden-import:

  pyinstaller --onefile --hidden-import=missing_module_name your_script.py
  

• Also, make sure your script uses relative paths (via os.path or pathlib) instead of Mac-specific absolute paths (like /Users/you/file.txt)—these will break on Windows.

Alternative 1: No packaging required (simplest option) #

If your end user doesn't mind running a command, skip packaging entirely:

1. On your Mac, generate a requirements.txt file listing your dependencies:

   pip freeze > requirements.txt
   

2. Send your_script.py and requirements.txt to the Windows user.
3. They install Python (match your script's Python version!), then run:

   pip install -r requirements.txt
   python your_script.py
   

This is zero-fuss and avoids all packaging headaches.

Alternative 2: Use PyOxidizer (more reliable than PyInstaller for some cases) #

PyOxidizer packages your script with a fully embedded Python runtime, which can avoid missing dependency issues:

1. On Windows, install it:

   pip install pyoxidizer
   

2. Initialize a project and replace the default script with yours:

   pyoxidizer init-config my_script_app
   cd my_script_app
   # Replace src/main.py with your script code
   

3. Edit pyoxidizer.toml to add your dependencies (look for the packages section and add your libraries).
4. Build the EXE:

   pyoxidizer build
   

The final executable will be in build/x86_64-pc-windows-msvc/release/install—it's standalone and ready to run.

Alternative 3: Use Nuitka (compile Python to C for better compatibility) #

Nuitka converts your Python code to C, then compiles it, which can resolve weird runtime errors that PyInstaller hits:

1. On Windows, install Nuitka (you'll need a C compiler—Nuitka will prompt you to install one if missing):

   pip install nuitka
   

2. Build your script as a single EXE:

   python -m nuitka --onefile your_script.py
   

It automatically handles most dependencies, and the resulting EXE is often more stable than PyInstaller builds.

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