使用cx_Freeze打包Tkinter程序后图标无法加载的问题

问题原因 #

1. 打包后__file__指向cx_Freeze生成的临时脚本文件，而非原源码路径，导致图标路径错误。
2. 图标文件icon.ico未被cx_Freeze纳入打包资源，运行时无法找到。
3. 手动替换路径分隔符易出错，未使用系统原生路径处理方法。

解决方案 #

1. 修正代码中的路径获取逻辑 #

用sys.executable区分打包/源码运行场景，结合os.path工具安全拼接路径，同时增加容错判断：

import tkinter as tk
import tkinter.filedialog as FileDialog
from tkhtmlview import HTMLLabel
import markdown
import sys
import os

# 获取程序根目录
if getattr(sys, 'frozen', False):
    # 打包后运行的情况
    dir_name = os.path.dirname(sys.executable)
else:
    # 源码直接运行的情况
    dir_name = os.path.dirname(__file__)

# 安全拼接图标路径
icon_dir = os.path.join(dir_name, "icon.ico")

def display_markdown(markdown_text):
    html_content = markdown.markdown(markdown_text)

    window = tk.Tk()
    # 图标存在才设置，避免报错中断程序
    if os.path.exists(icon_dir):
        window.iconbitmap(icon_dir)
    window.title("Markdown Reader")

    html_label = HTMLLabel(window, html=html_content)
    html_label.pack(expand=True, fill="both")

    window.mainloop()

def display_markdown_from_file(file_path):
    with open(file_path, 'r', encoding='utf-8') as file:
        markdown_text = file.read()
    display_markdown(markdown_text)

if __name__ == "__main__":
    if len(sys.argv) == 2:
        display_markdown_from_file(sys.argv[1])
    else:
        file = FileDialog.askopenfile(mode="r", filetypes=[("Markdown Files", "*.md *.markdown")], title="Open Markdown File")
        if file is not None:
            content = file.read()
            display_markdown(content)

2. 配置cx_Freeze的setup.py，包含图标资源 #

创建setup.py文件，明确打包脚本和需包含的资源：

import sys
from cx_Freeze import setup, Executable

# 替换为你的主脚本文件名
script_name = "markdown_reader.py"

base = None
if sys.platform == "win32":
    base = "Win32GUI"  # GUI程序隐藏控制台窗口

executables = [Executable(script_name, base=base)]

setup(
    name="MarkdownReader",
    version="1.0",
    description="Markdown阅读器",
    executables=executables,
    options={
        "build_exe": {
            "include_files": ["icon.ico"],  # 强制包含图标文件
            "includes": ["markdown", "tkhtmlview"]  # 确保依赖库被打包
        }
    }
)

3. 执行打包命令 #

在命令行运行：

python setup.py build

打包完成后，icon.ico会被复制到build目录下的程序文件夹中，运行生成的exe即可正常加载图标。

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