如何将含PyMySQL与.ico的多文件Python程序打包为独立可执行文件？

Hey there! Let's get your Python university app packaged up properly—PyInstaller can handle all your needs (multiple files, PyMySQL, and your .ico icon), you just might have missed a few key steps. Let's break this down step by step, since you're new to Python packaging.

Before you even touch PyInstaller, make sure your files are organized cleanly so the tool can track everything correctly. A typical setup should look like this:

your-university-app/
├── main.py          # This is your app's entry point (run this to launch the app)
├── student_utils.py # Example of another .py file your app uses
├── database.py      # Another module, e.g., handles PyMySQL connections
└── campus-icon.ico  # Your custom .ico icon file

First, confirm that running python main.py works perfectly on your machine—this ensures all imports (including PyMySQL) are set up correctly, which is critical for packaging.

Old versions of PyInstaller can cause weird dependency or packaging bugs, so start by grabbing the latest version:

pip install --upgrade pyinstaller

This single command will bundle all your .py files, PyMySQL, and your icon into one standalone exe. Let's break down each part so you know what's happening:

• -F: Forces PyInstaller to create a single, self-contained exe file (instead of a folder full of files)
• -i campus-icon.ico: Tells the tool to use your custom icon for the exe
• main.py: Specifies your app's entry point (the file that starts everything)

Here's the full command to run in your project folder:

pyinstaller -F -i campus-icon.ico main.py

PyInstaller will automatically scan main.py for all imported modules (including PyMySQL) and bundle them into the exe—you don't need to manually add dependencies unless it misses something (we'll cover that next).

After the command finishes, you'll see a new dist folder in your project. Inside it, you'll find your standalone exe (named main.exe on Windows). Test it by:

1. Running it directly on your machine to confirm it works as expected
2. Moving it to a computer without Python installed to verify it runs without needing PyMySQL pre-installed

If your earlier attempts failed, here are the most likely culprits and fixes:

• PyMySQL isn't being bundled: Sometimes PyInstaller misses hidden imports. Force it to include PyMySQL with this command:

  pyinstaller -F -i campus-icon.ico --hidden-import=pymysql main.py
  

• Other .py files aren't working: Make sure you're importing them correctly in main.py (e.g., import student_utils if the file is in the same folder). If your modules are in a subfolder, add an empty __init__.py file to that folder so Python recognizes it as a package.
• Icon isn't showing up: Double-check that your .ico file is valid (some files renamed to .ico are actually PNGs). Use an icon editor or online converter to generate a proper .ico file. Also, Windows might take a minute to refresh the icon—try restarting File Explorer if it doesn't show up immediately.
• Exe crashes silently: Run the exe from Command Prompt (just type main.exe in the dist folder) to see error messages. This will tell you if a dependency is missing, a database connection is broken, or another issue is causing the crash.

You mentioned wanting an uneditable executable—good news! PyInstaller converts your .py files into compiled bytecode (.pyc equivalent) and embeds them into the exe. Users won't be able to view or edit your original Python code directly.

Take it slow, test each step, and you'll have your standalone app ready in no time.

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