Mac下PyInstaller打包Python应用：数据文件路径定位问题

核心问题根源 #

Mac的.app包运行时，默认工作目录并非内部可执行文件所在路径，且PyInstaller打包后会将资源临时解压到特定目录，直接用相对路径读取数据文件必然失败。另外，直接运行打包出的可执行文件会弹出终端是因为Mac将其识别为控制台程序，而.app是GUI程序容器，这是正常现象，无需纠结。

解决步骤 #

1. 打包时正确包含数据文件

使用PyInstaller的--add-data参数，将数据文件或目录打包进.app包中。命令格式如下：

# 单个文件：将data.txt打包到可执行文件同目录
pyinstaller --noconsole --add-data "data.txt:." your_script.py

# 多个文件/目录：将data文件夹下所有内容打包到app内的data子目录
pyinstaller --noconsole --add-data "data/*:data/" your_script.py

注意：Mac/Linux下路径分隔用冒号:，这里针对Mac环境使用该符号。

2. 修改Python代码，动态获取数据文件路径

不能用固定相对路径读取文件，要通过PyInstaller提供的sys._MEIPASS变量（打包后运行时指向临时资源目录）或当前脚本的绝对路径来拼接数据文件路径。示例代码：

import os
import sys

def get_resource_path(relative_path):
    # 打包后运行时，使用PyInstaller的临时资源目录
    if hasattr(sys, '_MEIPASS'):
        return os.path.join(sys._MEIPASS, relative_path)
    # 开发环境下，使用当前脚本所在目录拼接路径
    return os.path.join(os.path.dirname(os.path.abspath(__file__)), relative_path)

# 读取数据文件示例
data_file_path = get_resource_path("data.txt")
# 如果是目录下的文件，比如data/config.ini，就写成get_resource_path("data/config.ini")
with open(data_file_path, 'r', encoding='utf-8') as f:
    content = f.read()

3. 验证打包结果

打包完成后，右键生成的.app文件选择「显示包内容」，进入Contents/MacOS目录（或你指定的子目录），确认数据文件已被包含在内。运行.app即可正常读取数据。

额外说明 #

Windows下无需.app包，直接将数据文件放可执行文件同目录即可，是因为Windows下可执行文件运行时的工作目录默认是自身所在路径，而Mac的.app包运行机制不同，必须通过动态路径适配。

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