### PyInstaller 打包 Python 脚本时加载同一目录下数据文件失败的解决方案 当使用 PyInstaller 将 Python 脚本打包为 `.exe` 文件后，可能会遇到无法正确加载与脚本位于同一目录下的数据文件的问题。这是因为打包后的程序运行时的工作目录可能并非预期中的脚本所在目录。 #### 工作原理分析 PyInstaller 打包后的应用程序会在临时解压目录中运行[^1]。这意味着即使原始脚本与其所需的数据文件在同一目录下，在打包并运行之后，这些文件的实际位置会改变到一个临时路径中。因此，直接通过相对路径访问数据文件可能导致错误。 #### 解决方法 为了确保能够正确加载数据文件，可以采用以下几种方式： 1. **动态获取资源路径** 使用 `sys._MEIPASS` 动态定位资源文件的位置。这是 PyInstaller 提供的一个特殊变量，用于指向解压缩的应用程序及其依赖项所在的临时目录。 下面是一个通用函数来处理不同场景下的资源路径： ```python import os import sys def resource_path(relative_path): """ 获取资源的真实路径 """ try: base_path = sys._MEIPASS # 当处于打包状态时，返回的是临时解压目录 except Exception: base_path = os.path.abspath(".") # 正常调试状态下，返回当前工作目录 return os.path.join(base_path, relative_path) ``` 在实际代码中调用此函数即可获得正确的文件路径： ```python data_file = resource_path("data.txt") # 假设有一个名为 'data.txt' 的文件 with open(data_file, "r", encoding="utf-8") as file: content = file.read() print(content) ``` 2. **设置 --add-data 参数** 如果项目中有多个外部数据文件或者整个子目录需要包含进去，可以通过命令行参数 `--add-data` 来显式声明哪些文件应该被加入最终的可执行文件中[^2]。注意 Windows 和其他平台之间分隔符的不同写法： - 对于 Windows 平台：`source;destination` - 对于 Linux/MacOS 平台：`source:destination` 示例命令如下所示（假设要添加一个叫做 config.json 的配置文件）： ```bash pyinstaller your_script.py --onefile --add-data "config.json;." ``` 上述例子表示将 `config.json` 添加至输出 EXE 中，并放置在其根目录之下。 3. **调整工作目录** 另一种办法是在启动阶段修改进程的工作目录回原来的脚本所在位置。这通常适用于那些硬编码了固定相对路径读取逻辑的老版本遗留软件改造情况。 ```python if getattr(sys, 'frozen', False): # 判断是否已经过 PyInstaller 打包 current_dir = os.path.dirname(sys.executable) # 获取 .exe 文件所在目录 else: current_dir = os.getcwd() # 开发环境中保持原样 os.chdir(current_dir) # 改变当前工作目录 ``` 以上三种策略可以根据具体需求单独选用或是组合起来运用以解决问题。 ```python import os import sys def resource_path(relative_path): """ Get absolute path to resource, works for dev and for PyInstaller """ try: # PyInstaller creates a temp folder and stores path in _MEIPASS base_path = sys._MEIPASS except Exception: base_path = os.path.abspath(".") return os.path.join(base_path, relative_path) if __name__ == "__main__": data_file = resource_path('example_data.csv') with open(data_file, mode='r') as f: lines = f.readlines() for line in lines[:5]: print(line.strip()) ```