如何使用PyInstaller打包含多文件、第三方依赖及静态资源的复杂Python程序？

Let's break down your problem step by step—this is a common pain point with PyInstaller when dealing with external dependencies and static files, especially with OpenCV. The "NoneType object has no attribute shape" error is almost always a path issue: your packaged exe can't find the image files you're trying to load with OpenCV. Here's how to fix everything:

1. Fix the OpenCV Image Loading Error #

PyInstaller extracts your app to a temporary system folder at runtime, so your hardcoded relative paths won't work anymore. Replace all your image file paths with a dynamic path resolver:

import sys
import os

def get_resource_path(relative_path):
    try:
        # PyInstaller sets this variable to the temp folder path
        base_path = sys._MEIPASS
    except Exception:
        # Fallback to local path for development
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

# Use this function everywhere you load images
img = cv2.imread(get_resource_path("images/your_image.png"))

Now you need to tell PyInstaller to include these image files in the package. Using a spec file is more reliable for complex projects than command-line flags alone.

2. Handle Your Multi-File Program Structure #

Since you have 7-8 Python files imported into your main script, PyInstaller should auto-detect most imports, but a spec file gives you explicit control. Generate one first:

pyi-makespec --onefile myprogram.py

Open the generated myprogram.spec file and modify the datas and hiddenimports sections to cover your assets and any missing modules:

a = Analysis(
    ['myprogram.py'],
    pathex=[],
    binaries=[],
    # Add your image folder here: (source_path, destination_in_package)
    datas=[('images/*', 'images')],
    hiddenimports=['cv2', 'pytesseract'],  # Add any imports PyInstaller might miss
    hookspath=[],
    hooksconfig={},
    runtime_hooks=[],
    excludes=[],
    noarchive=False,
)

3. Package External Dependencies (pytesseract & AHK) #

These aren't Python libraries—they're external executables, so you need to bundle them manually:

For pytesseract: #

1. Locate your Tesseract-OCR installation folder (usually C:\Program Files\Tesseract-OCR on Windows).
2. Copy the entire folder into your project root.
3. Update your spec file's datas to include it:

   datas=[('images/*', 'images'), ('Tesseract-OCR/*', 'Tesseract-OCR')],
   

4. Update your code to point to the bundled Tesseract executable:

   pytesseract.pytesseract.tesseract_cmd = get_resource_path("Tesseract-OCR/tesseract.exe")
   

For AHK: #

1. Copy your ahk.exe or AHK script files into your project root.
2. Add them to the spec file's datas:

   # If bundling ahk.exe:
   datas=[('images/*', 'images'), ('Tesseract-OCR/*', 'Tesseract-OCR'), ('ahk.exe', '.')]
   # If bundling a script:
   datas=[('images/*', 'images'), ('Tesseract-OCR/*', 'Tesseract-OCR'), ('your_script.ahk', '.')]
   

3. Use get_resource_path when calling AHK in your code to reference the bundled file.

4. Build the Final Executable #

Once your spec file is configured, run this command to build the single-file exe:

pyinstaller myprogram.spec

Quick Testing Tip #

After building, move the exe to a different folder (away from your project files) and run it—this ensures it's using the bundled resources instead of local files on your machine.

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