### 解决方案 当使用 `PyInstaller` 将 Python 脚本打包为可执行文件 (`.exe`) 后运行时，可能会因为路径问题引发 `FileNotFoundError: The path does not exist` 错误。这种错误通常发生在程序尝试访问某些资源文件（如配置文件、模型权重或其他依赖项）时。 以下是针对此问题的解决方案： #### 修改代码逻辑以适配打包后的环境 在打包过程中，`PyInstaller` 会将整个应用程序及其依赖项嵌入到单个目录或单个可执行文件中。因此，在运行 `.exe` 文件时，当前工作目录可能与开发环境中不同。为了兼容这两种情况（即未打包状态和已打包状态），可以修改代码如下[^2]： ```python import os import sys def get_application_path(): if getattr(sys, 'frozen', False): # 判断是否为打包后的可执行文件 application_path = os.path.dirname(sys.executable) # 获取可执行文件所在目录 else: application_path = os.sep.join(os.path.abspath(__file__).split(os.sep)[:-3]) # 开发模式下的根路径 return application_path root_path = get_application_path() ``` 通过上述代码片段，可以在运行时动态获取正确的应用路径，无论是在开发环境下还是作为独立的 `.exe` 运行。 --- #### 配置 PyInstaller 的数据文件加载方式 如果您的项目中有额外的数据文件（例如图片、音频、模型等），需要确保这些文件能够被正确包含并加载。可以通过以下两种方法实现： 1. **指定 `--add-data` 参数** 使用命令行选项 `--add-data` 来显式声明哪些文件应随同主脚本一起被打包。语法如下： ```bash pyinstaller --onefile --add-data "source_file;destination_folder" your_script.py ``` 对于 Windows 平台，分号 (`;`) 是路径之间的分隔符；而对于 Linux 或 macOS，则使用冒号 (`:`)[^1]。 2. **调整资源文件读取路径** 当您成功将所需文件加入打包范围后，还需要更新代码中的文件读取部分。推荐的做法是从相对路径切换至绝对路径，并结合前面提到的应用路径函数来构建完整的文件名。例如： ```python resource_name = "example_model.pkl" full_resource_path = os.path.join(root_path, resource_name) with open(full_resource_path, 'rb') as f: model_data = pickle.load(f) ``` --- #### 设置解释器路径（适用于特定场景） 对于一些特殊需求，比如强制指定 Python 解释器的位置，也可以考虑在脚本的第一行添加硬编码形式的解释器路径[^3]： ```python #!/usr/bin/env python3 ``` 不过需要注意的是，这种方法仅适合源码调试阶段，而不会影响最终生成的 `.exe` 行为。 --- #### 测试用例验证 如果您正在处理多参数输入的情况，建议编写单元测试覆盖各种边界条件。下面是一个简单的例子展示如何模拟命令行调用以及捕获异常情形[^4]： ```cpp TEST_METHOD(test_arg_exc5) { std::vector<char*> argv = {"Wordlist.exe", "-n", "-w", "test"}; const char* expected_info = "Invalid combination of arguments."; EXPECT_THROW({ test_arg_exception(argv.size(), &argv[0], expected_info); }, std::runtime_error); } ``` 尽管这是 C++ 中的一个片段，但它体现了良好的实践原则——始终确认用户提供的参数合法性！ --- ### 总结 综上所述，要彻底解决由路径引起的 `FileNotFoundError` 错误，需从以下几个方面入手：一是改进脚本内部关于路径判定的部分；二是合理利用 `PyInstaller` 提供的功能完成外部资源集成；三是充分考虑到实际部署环境差异带来的潜在风险因素。