PyInstaller打包后无法找到data目录下圣经文本文件求助

1. 检查macOS下--add-data参数格式 #

macOS中PyInstaller的--add-data需用冒号分隔源路径与目标路径，而非Windows的分号。正确命令示例：

# 打包单个目录下的所有txt文件
pyinstaller --add-data "./data/*.txt:./data/" your_script.py
# 打包整个data目录
pyinstaller --add-data "./data:./data/" your_script.py

若使用.spec文件，确保datas配置如下：

datas=[('./data', './data')],

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

打包后PyInstaller会将资源文件临时解压到sys._MEIPASS目录，不能直接使用相对路径./data/KJV.txt，需动态适配路径：

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)

# 使用示例
kjv_file_path = get_resource_path('data/KJV.txt')
with open(kjv_file_path, 'r') as f:
    # 处理文件内容
    pass

避免使用get_executable_dir()，macOS的.app包结构中可执行文件与资源文件的位置分离，该方法无法准确获取资源路径

3. 验证.app包内的资源完整性 #

打包完成后，右键.app文件选择「显示包内容」，检查Contents/Resources/目录下是否存在data文件夹及对应txt文件。若缺失，说明--add-data参数配置错误，需调整后重新打包。

4. py2app适配方案 #

若使用py2app，需在setup.py中明确指定资源文件：

from setuptools import setup

APP = ['your_script.py']
DATA_FILES = ['data']
OPTIONS = {
    'argv_emulation': True,
    'packages': ['your_dependencies'],
}

setup(
    app=APP,
    data_files=DATA_FILES,
    options={'py2app': OPTIONS},
    setup_requires=['py2app'],
)

代码中路径获取需适配py2app的包结构：

import os
import sys

def get_resource_path(relative_path):
    if getattr(sys, 'frozen', False):
        # py2app打包后资源位于Contents/Resources目录
        base_path = os.path.join(os.path.dirname(sys.executable), '..', 'Resources')
    else:
        base_path = os.path.abspath('.')
    return os.path.join(base_path, relative_path)

常见坑点 #

• macOS路径区分大小写，确保代码中文件名与实际文件完全一致（如KJV.txt不可写为kjv.txt）
• 禁止使用硬编码绝对路径，必须通过动态方法获取资源路径
• 若使用虚拟环境，需激活环境后再执行打包命令

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