PyInstaller依赖工作机制及打包后文本文件找不到问题咨询

1. 修正文件路径引用逻辑 #

打包后的可执行文件运行时，工作目录和开发时的脚本目录不一致，直接用相对路径会找不到文件。你需要通过代码动态获取正确的文件路径：

import os
import sys

def get_data_file_path(filename):
    # 打包后，PyInstaller会把资源文件放到临时目录，sys._MEIPASS指向该目录
    if hasattr(sys, '_MEIPASS'):
        return os.path.join(sys._MEIPASS, filename)
    # 开发环境下，直接取脚本所在目录的文件
    return os.path.join(os.path.dirname(__file__), filename)

# 使用示例
file_path = get_data_file_path("你的数据文件名.txt")
with open(file_path, "r", encoding="utf-8") as f:
    data = f.read()

2. 打包时包含文本文件 #

执行PyInstaller命令时，必须显式指定要打包的非代码资源文件，否则这些文件不会被包含进最终的exe或dist目录：

• Windows系统：

pyinstaller --add-data "你的数据文件名.txt;." 你的脚本名.py

（分号;分隔源文件和目标路径，.表示和exe同目录）

• Linux/macOS系统：

pyinstaller --add-data "你的数据文件名.txt:." 你的脚本名.py

（冒号:分隔源文件和目标路径）

如果是单文件打包（加-F参数），上述命令会把文本文件打包进exe，运行时自动解压到临时目录，配合第一步的路径逻辑就能正确读取。

1. 静态依赖分析：PyInstaller会遍历你的Python脚本，解析所有import语句，自动收集依赖的标准库、第三方库的二进制文件（如.pyd、.dll）、编译后的.pyc文件。

2. 打包模式：

   • 目录模式（默认）：所有依赖文件会被放到dist目录下，和生成的exe文件同级，运行时直接读取这些文件。
   • 单文件模式（-F参数）：所有依赖会被打包进单个exe文件，运行时exe会自动将依赖解压到系统临时目录（路径由sys._MEIPASS指向），执行完成后临时文件会被清理。

3. 动态导入处理：如果你的代码使用了动态导入（如importlib.import_module），PyInstaller的静态分析无法识别这些依赖，需要用--hidden-import参数手动指定，比如：

pyinstaller --hidden-import "需要导入的模块名" 你的脚本名.py

4. 钩子机制：PyInstaller内置了大量钩子文件，用于处理特殊库的依赖（比如PyQt、numpy这类有额外资源或动态依赖的库）。如果某个第三方库打包后报错，可能需要自定义钩子文件，并用--additional-hooks-dir参数指定钩子目录。

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