理解 PyInstaller 可执行文件的文件查找机制
当您使用 pyinstaller 将 python 脚本打包成独立的 .exe 可执行文件后，程序运行时对于非脚本文件（如 .txt、.csv、.json、图片、配置文件等）的查找行为，与在开发环境中直接运行 python 脚本有所不同。核心在于，像 open() 这样的文件操作函数，默认会在当前工作目录 (current working directory, cwd) 中查找指定的文件。
对于一个由 PyInstaller 生成的 .exe 文件，当它被执行时，其默认的当前工作目录通常就是该 .exe 文件所在的目录。这意味着，如果您的程序尝试打开一个名为 info.txt 的文件，它会首先在 .exe 文件所在的目录中寻找 info.txt。如果文件不在那里，就会报告文件未找到的错误。
核心解决方案：同目录部署
解决 PyInstaller 打包程序无法找到外部非脚本文件最直接且最常用的方法，就是确保这些文件与生成的 .exe 可执行文件位于相同的目录下。
正确的文件部署示例：
假设您的程序 main.py 需要访问一个名为 info.txt 的文本文件。在 PyInstaller 打包并生成 main.exe 后，您应该将 info.txt 放置在与 main.exe 相同的文件夹中。
program\
main.exe
info.txt
在这种结构下，当 main.exe 运行时，它会将其所在目录 (program\) 设为当前工作目录，因此能够成功找到并访问 info.txt。
审查 Next.js App Router 代码库，检查 React Server Component 边界错误、请求瀑布、客户端/服务端反模式以及 Core Web Vitals 风险...
错误的文件部署示例：
如果您将 main.exe 移动到其他目录，而 info.txt 仍留在原始位置，程序将无法找到该文件。
program\
info.txt
desktop\
main.exe
在此示例中，当您从 desktop\ 目录运行 main.exe 时，程序会尝试在 desktop\ 目录中查找 info.txt。由于 info.txt 位于 program\ 目录，程序将无法找到它，从而导致运行时错误。
注意事项
- 相对路径与当前工作目录： 这种解决方案主要依赖于文件操作函数（如 open()）默认在当前工作目录中查找文件的行为。如果您的代码中使用了硬编码的绝对路径，那么这种部署方式可能不会起作用，您需要确保路径在打包后依然有效。通常建议使用相对路径，并配合上述同目录部署策略。
- 动态获取文件路径： 对于更复杂的场景，例如程序需要根据用户输入或配置动态加载文件，或者文件位于子目录中，您可能需要在程序中编写逻辑来构建正确的文件路径。例如，可以使用 os.path.join(os.path.dirname(sys.executable), 'data', 'info.txt') 来构建相对于可执行文件目录的路径。
- 在线托管作为备选： 在某些特定情况下，如果外部文件非常大、需要频繁更新或不适合随可执行文件一起分发，您可以考虑将其托管在云端或网络服务器上。程序在运行时通过网络请求下载或访问这些文件。但这通常会增加程序的复杂性、对网络连接的依赖性，并且可能引入安全性问题，因此应谨慎使用，并确保有适当的错误处理机制。
总结
通过 PyInstaller 打包 Python 程序时，管理非脚本文件依赖的关键在于理解可执行文件的文件查找机制。最简单有效的策略是确保所有必要的非脚本文件与生成的 .exe 文件一同部署在相同的目录下。这使得程序能够利用其默认的当前工作目录来成功定位和访问所需的数据，从而保证程序的正常运行。对于更复杂的部署需求，可以结合路径构建函数或考虑在线托管等高级方案。
