使用PyInstaller编译Tkinter程序时，如何正确引入同目录模块？

我之前也碰到过类似的打包坑，结合你的情况，咱们一步步来排查和解决：

1. 先确认导入语句的正确性 #

首先检查gui.py里对functions.py的导入方式，尽量用绝对导入（两个文件在同一目录的前提下）：

# 推荐写法
import functions
# 或者明确导入需要的函数
from functions import your_target_function1, your_target_function2

避免用相对导入（比如from . import functions），PyInstaller对相对导入的处理在单文件模式下很容易出问题。

2. 正确使用--hidden-import参数 #

你提到用过这个参数但无效，大概率是格式不对。正确的打包命令应该是这样的：

pyinstaller --onefile --hidden-import=functions gui.py

如果functions.py还依赖其他第三方库（比如requests、pandas这类），也要把这些库一并加入--hidden-import：

pyinstaller --onefile --hidden-import=functions --hidden-import=requests gui.py

3. 用自定义钩子强制收集依赖 #

如果--hidden-import还是不管用，可以试试自定义钩子文件：

• 在项目根目录创建hook-functions.py，内容如下：

from PyInstaller.utils.hooks import collect_all

# 完整收集functions模块的所有依赖、数据文件和二进制文件
datas, binaries, hiddenimports = collect_all('functions')

• 然后用这条命令打包：

pyinstaller --onefile --additional-hooks-dir=. gui.py

这个钩子会告诉PyInstaller把functions模块的所有内容都打包进去，避免遗漏隐性依赖。

4. 排查文件路径问题 #

如果functions.py里涉及读取本地文件（比如配置文件、图片、数据文件），打包成单文件后，程序会临时解压到系统临时目录，原来的相对路径就失效了。你需要在functions.py里加一段路径处理逻辑：

import os
import sys

def get_resource_path(relative_path):
    try:
        # 打包后PyInstaller会自动设置这个变量指向临时解压目录
        base_path = sys._MEIPASS
    except Exception:
        # 开发模式下用当前目录
        base_path = os.path.abspath(".")
    return os.path.join(base_path, relative_path)

# 示例：用这个函数读取数据文件
data_file = get_resource_path("config.ini")
with open(data_file, "r") as f:
    config = f.read()

同时打包时要把这些资源文件包含进去，用--add-data参数：

# Windows系统
pyinstaller --onefile --hidden-import=functions --add-data "config.ini;." gui.py
# macOS/Linux系统
pyinstaller --onefile --hidden-import=functions --add-data "config.ini:." gui.py

5. 查看错误日志定位问题 #

别双击运行生成的exe，打开命令提示符直接运行exe文件，这样能看到控制台输出的错误信息（比如ImportError、FileNotFoundError），这是排查问题最直接的方法。
另外，打包时可以开启日志模式，看看PyInstaller的收集过程：

pyinstaller --onefile --hidden-import=functions --log-level=INFO gui.py

日志里会显示哪些模块被收集、哪些被跳过，方便定位遗漏的依赖。

6. 用最小化案例测试 #

如果还是找不到问题，建议先做个最小化测试案例：

• test_gui.py：

import tkinter as tk
import functions

def on_click():
    functions.test_run()

root = tk.Tk()
btn = tk.Button(root, text="测试功能", command=on_click)
btn.pack()
root.mainloop()

• test_functions.py：

def test_run():
    print("功能正常运行！")

用这个案例打包测试，如果能正常运行，说明你的原代码里有特定的依赖或路径问题，再逐步添加原代码的功能来排查。

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