使用PyInstaller将.py转.exe失败求助：23个脚本仅1个无法转换

Hey there, sorry to hear one out of 23 scripts is giving you grief while the rest packaged up smoothly! Let’s walk through some practical fixes to get that last one converted to .exe successfully.

Common Causes & Fixes #

1. Double-check Relative Paths in the Script #

Even if your script runs fine locally, PyInstaller packages files into a temporary runtime directory, which can break hardcoded relative paths. For example, if your script loads a data file like open("config.json"), try rewriting the path to use the script’s actual location:

import os
# Get the absolute path of your script's directory
script_dir = os.path.dirname(os.path.abspath(__file__))
# Build the full path to your resource
config_path = os.path.join(script_dir, "config.json")

Also verify if you’re importing local modules from the same directory—sometimes PyInstaller misses these unless explicitly referenced.

2. Clear PyInstaller’s Cache Files #

Cached build files can cause weird, inconsistent errors. Delete the auto-generated folders and spec file first:

# Windows Command Prompt
rmdir /s /q build dist
del your_script_name.spec

# Linux/macOS
rm -rf build dist your_script_name.spec

Then re-run your PyInstaller command from scratch: pyinstaller your_script.py

3. Generate and Tweak a Spec File #

Spec files give you more control over the packaging process. First generate one:

pyinstaller --name MyApp your_script.py

Open the resulting MyApp.spec file and:

• Confirm your target script is listed in the scripts array under Analysis
• Add any missing data files (like images, configs) to the datas list, e.g.:

  datas=[('assets/icon.png', 'assets'), ('config.ini', '.')],
  

• If you’re using dynamic imports or obscure libraries, add them to hiddenimports:

  hiddenimports=['some_obscure_module'],
  

Then repackage using the spec file: pyinstaller MyApp.spec

4. Enable Debug Logging for Clues #

Run PyInstaller with full debug logging to pinpoint exactly where it’s failing:

pyinstaller --debug=all your_script.py

The verbose output will show you which file, import, or step is causing the error—this is often the fastest way to diagnose tricky issues.

5. Verify the Script Runs Without PyInstaller #

Before blaming PyInstaller, make sure the script itself runs flawlessly:

python your_script.py

Sometimes hidden runtime errors (like missing environment variables or untested code paths) only surface during packaging.

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