### Python 使用 PyInstaller 打包 EXE 文件时相对路径无法运行的解决方案 当使用 `PyInstaller` 将 Python 脚本打包为可执行文件 (EXE) 后，如果脚本中涉及相对路径操作，则可能会因为工作目录的变化而导致程序异常退出或功能失效。以下是针对该问题的具体分析与解决方案。 #### 1. 工作目录变化的原因 在未打包的情况下，Python 脚本的工作目录通常是脚本所在的目录。然而，在通过 `PyInstaller` 打包后的单文件模式 (`--onefile`) 中，实际解压并运行的是临时目录中的内容[^1]。因此，原本基于当前工作目录的相对路径可能不再有效。 --- #### 2. 获取正确的资源路径方法 为了确保无论是在开发环境还是打包环境中都能正确访问资源文件，可以通过以下方式动态获取资源的实际路径： ```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) # 示例：读取名为 config.json 的配置文件 config_file_path = resource_path("config.json") with open(config_file_path, 'r') as file: data = file.read() ``` 此函数会判断当前是否处于打包状态，并返回对应的绝对路径[^2]。 --- #### 3. 配置日志文件生成位置 部分情况下，程序运行失败可能是由于尝试写入的日志文件路径不可用所致。为了避免此类问题，建议显式指定日志文件的位置，例如将其存储到用户的文档目录或其他允许写入的地方。 ```python import logging from pathlib import Path logs_dir = Path.home() / "Documents" / "MyAppLogs" logs_dir.mkdir(parents=True, exist_ok=True) log_file = logs_dir / "app.log" logging.basicConfig( filename=log_file, level=logging.DEBUG, format="%(asctime)s:%(levelname)s:%(message)s" ) logger = logging.getLogger() logger.info("Application started.") ``` 这样即使在打包环境下也能正常创建和写入日志文件[^2]。 --- #### 4. 处理中文路径问题 如果目标文件夹名称包含中文字符，可能导致编码错误从而引发崩溃。对此可通过设置默认编码来规避潜在风险： ```python import locale locale.setlocale(locale.LC_ALL, '') # 设置本地化支持 sys.stdout.reconfigure(encoding='utf-8') sys.stderr.reconfiguration(encoding='utf-8') ``` 另外需要注意的是，某些操作系统对于特定区域的语言可能存在兼容性缺陷，必要时应测试不同平台下的表现[^3]。 --- #### 5. 命令行参数优化 最后提醒一点，在调用外部命令或者处理子进程时务必小心传递字符串的方式以免引起解析歧义。推荐做法如下所示： ```python import subprocess process_name = "notepad.exe" subprocess.run(['taskkill', '/F', '/IM', process_name], check=True) ``` 相比原始实现更加安全可靠[^4]。 --- ### 总结 综上所述，解决 Python 程序经由 PyInstaller 打包后因相对路径引起的各类问题是可行的。关键是理解两者之间差异之处并通过适当调整代码逻辑加以应对。