使用Nuitka打包Python脚本为EXE时嵌入资源目录的问题求助

项目结构 #

Myproject
├─ images
│  ├─ image1.png
│  ├─ image2.png
│  ├─ image3.png
├─ requirements.txt
├─ scapper.py
├─ GUI.py
└─ Utils
   └─ chromedriver.exe

问题与错误 #

初始编译命令生成的EXE仅能在原项目目录运行，移动后必须同步复制images文件夹才能正常工作。尝试修改命令时出现路径语法错误：

OSError: [WinError 123] 文件名、目录名或卷标语法不正确: 'GUI.dist\images*'

初始编译命令：

python -m nuitka --standalone --onefile --show-progress --windows-disable-console --include-data-dir=D:\VS-CODE\XCALLY\images=images --include-data-dir=D:\VS-CODE\XCALLY\Utils=Utils --enable-plugin=tk-inter GUI.py

错误修改命令：

python -m nuitka --standalone --onefile --show-progress --windows-disable-console --include-data-dir=images=images\* --include-data-dir=Utils=Utils\* --enable-plugin=tk-inter GUI.py

解决方案 #

1. 修正Nuitka编译命令 #

移除目标路径后的通配符*，使用正确的--include-data-dir语法（源目录=临时目录内的目标路径），若当前工作目录为Myproject，可直接用相对路径：

python -m nuitka --standalone --onefile --show-progress --windows-disable-console --include-data-dir=images=images --include-data-dir=Utils=Utils --enable-plugin=tk-inter GUI.py

2. 适配代码中的资源读取路径 #

单文件EXE运行时，Nuitka会将嵌入资源解压到临时目录，需通过sys._MEIPASS获取该路径，在GUI.py中添加资源路径获取逻辑：

import os
import sys

def get_resource_path(relative_path):
    if hasattr(sys, '_MEIPASS'):
        return os.path.join(sys._MEIPASS, relative_path)
    return os.path.join(os.path.abspath("."), relative_path)

# 示例：获取资源文件路径
image1_path = get_resource_path("images/image1.png")
chromedriver_path = get_resource_path("Utils/chromedriver.exe")

此逻辑兼容开发环境与打包后的EXE环境，确保资源路径始终正确。

关键说明 #

• --onefile参数会将所有依赖与资源打包为单个EXE，运行时自动解压到系统临时目录，sys._MEIPASS指向该临时目录。
• --include-data-dir无需通配符，指定源目录和临时目录内的目标路径即可完成资源嵌入。

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