### Python 中修改文件加载路径并使用 PyInstaller 进行打包 当使用 `PyInstaller` 将 Python 脚本打包成可执行文件时，可能会遇到文件加载路径不正确的问题。这是因为打包后的程序运行环境与原始开发环境不同，导致相对路径失效。 #### 解决方案概述 为了使程序能够正确找到资源文件，在代码中需要动态判断当前运行环境，并设置合适的绝对路径[^3]。以下是具体实现方式： --- #### 动态获取文件路径的代码示例 通过检测程序是否被冻结（即是否已被打包），可以分别处理源码运行和打包后运行的情况： ```python import sys import os def get_resource_path(relative_path): """ 获取资源文件的绝对路径 """ if getattr(sys, 'frozen', False): # 如果是打包后的程序 base_path = os.path.dirname(os.path.abspath(sys.executable)) else: # 开发环境中运行 base_path = os.path.dirname(os.path.abspath(__file__)) return os.path.join(base_path, relative_path) # 使用函数加载文件 resource_file = get_resource_path('data/your_file.txt') with open(resource_file, 'r') as f: content = f.read() print(content) ``` 上述代码片段定义了一个通用的方法 `get_resource_path()` 来计算资源文件的实际位置。 --- #### 打包过程中的注意事项 1. **单文件模式下的路径问题** 当使用 `-F/--onefile` 参数将整个应用程序压缩到一个单独的 `.exe` 文件时，所有依赖项都会解压到临时目录中。因此，如果脚本尝试访问某些外部文件，则这些文件也应放置在同一临时目录下[^4]。 2. **指定额外的数据文件** 可以利用 `--add-data` 参数告诉 PyInstaller 额外包含哪些数据文件及其目标存储位置。对于 Windows 和 Linux 平台来说，分隔符有所不同；Windows 使用分号 (`;`)，而其他平台则采用冒号 (`:`)[^2]。 示例命令： ```bash pyinstaller --add-data "data/your_file.txt;data" your_script.py ``` 此操作会把 `your_file.txt` 添加至最终生成的应用内部 `/data/` 子目录里。 3. **重新构建项目** 若已存在旧版规格配置文件 (`.spec`) ，记得先删除它再重新创建新的版本以便应用最新更改[^1]。 --- #### 完整流程演示 假设有一个简单的 Python 应用需要读取名为 `config.json` 的 JSON 数据文件，下面展示完整的解决方案步骤： ##### Step A: 编写主逻辑代码 保存为 `main.py`: ```python import json from pathlib import Path def load_config(): config_path = Path(get_resource_path("config/config.json")) with config_path.open() as file_handler: return json.load(file_handler) if __name__ == "__main__": configuration = load_config() print(f"Configuration Loaded:\n{json.dumps(configuration, indent=4)}") ``` 其中调用了之前提到过的辅助功能 `get_resource_path()` 方法来自适应不同的工作场景需求。 ##### Step B: 准备资产结构 确保项目的根目录具有如下布局形式： ``` project_root/ │ ├── main.py # 主入口点 └── config/ └── config.json # 待嵌入的静态资源配置表 ``` ##### Step C: 构建指令集 打开终端窗口切换至此处所在的工作区位址，输入下列语句完成编译任务： ```bash pyinstaller \ --noconfirm \ --onefile \ --console \ --add-data "./config/config.json;./config/" \ ./main.py ``` 这里特别强调的是附加参数部分指定了关联文档应当复制过去的具体子夹名称。 完成后即可获得独立运作形态的目标产物位于 dist 下面等待部署测试验证效果啦！ --- ###