使用Nuitka打包Tkinter项目时导入图片报文件不存在错误求解

问题原因 #

Nuitka单文件打包后，程序运行时会自动将所有资源解压到系统临时目录，此时程序的工作路径不再是你开发时的src文件夹，而是临时目录。你原来使用的相对路径是基于开发环境的目录结构，打包后临时目录里的资源结构和开发时不匹配，导致无法找到图片文件。

解决方案 #

核心思路是动态获取资源的实际路径，不管是开发环境还是打包后的exe，都能正确定位资源文件：

1. 编写资源路径获取辅助函数
   在main.py中添加以下代码：

import os
import sys

def get_resource_path(relative_path):
    # 判断是否为打包后的可执行文件
    if hasattr(sys, '_MEIPASS'):
        # sys._MEIPASS是Nuitka单文件打包时的临时资源目录路径
        base_dir = sys._MEIPASS
    else:
        # 开发环境下，获取项目根目录（src文件夹的上级目录）
        src_dir = os.path.dirname(os.path.abspath(__file__))
        base_dir = os.path.dirname(src_dir)
    # 拼接完整资源路径
    return os.path.join(base_dir, relative_path)

2. 修改图片导入语句
   将原来的相对路径替换为辅助函数生成的路径：

question_icon = PhotoImage(file=get_resource_path("res/img/question_icon_32.png"))

3. 确认打包命令正确性
   你的打包命令已正确配置资源目录，无需修改：

python -m nuitka --onefile --onefile-tempdir-spec="%TEMP%\onefile_%PID%_%TIME%" -o myprogram.exe --enable-plugin=tk-inter --include-data-dir="C:\...project_folder\res"=res --include-data-file="C:\...project_folder\src\changelog.md"=changelog.md C:\...project_folder\src\main.py

该命令会将res目录完整打包到临时目录中，和辅助函数的路径逻辑完全匹配。

额外说明 #

• 不要使用以/开头的路径，这不是系统绝对路径，而是相对于当前工作目录的路径，工作目录变化后会直接失效。
• 测试时可以打印get_resource_path返回的路径，确认开发环境和打包后的路径是否符合预期。

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