PyCharm Python项目打包单个可执行文件失败，求解决方案

Alright, let's work through getting your Python 3.4 PyCharm project packaged into a single executable with PyInstaller—since you hit a snag before, let's break down the steps and fix common pitfalls specific to your setup.

Python 3.4 is pretty old, and newer PyInstaller versions dropped support for it. You'll need to install a compatible release:

pip install pyinstaller==3.6

This version is the last one that officially supports Python 3.4, so it'll avoid compatibility crashes.

• Double-check that your project runs flawlessly in PyCharm before trying to package it. Fix any runtime errors (like missing imports or broken file paths) first—packaging won't fix underlying code issues.
• Make sure you know your project's entry script (the file you run to start the app, e.g., main.py). Set it as your PyCharm run configuration to confirm it's the correct starting point.

Open PyCharm's built-in Terminal (bottom toolbar, "Terminal" tab). If you're not already in your project root directory, navigate there with:

cd /path/to/your/project/folder

Then run the PyInstaller command tailored for a single executable:

# For GUI apps (hides the console window)
pyinstaller --onefile --windowed your_entry_script.py

# For command-line apps (keeps the console window)
pyinstaller --onefile your_entry_script.py

Replace your_entry_script.py with the actual name of your main script.

Missing dependencies #

If PyInstaller fails to pick up some libraries (you'll get import errors when running the exe), use the --hidden-import flag to manually add them. For example, if your app uses requests:

pyinstaller --onefile --hidden-import requests your_entry_script.py

Broken relative file paths #

If your code reads local files (like configs or data) with relative paths (e.g., open("data.txt")), the packaged exe won't find them—PyInstaller runs from a temporary folder. Fix this by modifying your code to use the sys._MEIPASS path:

import sys
import os

def get_resource_path(relative_path):
    try:
        # PyInstaller sets this temp path when running the exe
        base_path = sys._MEIPASS
    except Exception:
        # Fallback to project root when running in PyCharm
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

# Use this function to load files instead of direct relative paths
with open(get_resource_path("data.txt"), "r") as f:
    file_content = f.read()

Then tell PyInstaller to include these files with the --add-data flag (use ; for Windows, : for macOS/Linux):

# Windows example: include data.txt and place it in the same folder as the exe
pyinstaller --onefile --add-data "data.txt;." your_entry_script.py

Python 3.4-specific bugs #

Some older libraries might have compatibility quirks with PyInstaller 3.6. If you hit weird errors, try upgrading the problematic library to the latest version that supports Python 3.4, or add more --hidden-import flags to cover missing modules.

After the packaging finishes, PyInstaller creates a dist folder in your project root. Your single executable file will be inside this folder—just double-click it to test!

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