PyInstaller单文件打包后获取项目根路径与Python运行结果不一致的问题排查与解决

我来帮你拆解这个问题，顺便给你靠谱的解决方案——毕竟PyInstaller的--onefile模式确实容易踩这种路径坑。

首先得搞明白PyInstaller --onefile 参数的工作逻辑：

• 用这个参数打包后，所有代码、依赖会被塞进单个exe文件里。
• 当你双击运行这个exe时，它会偷偷把所有内容解压到系统的临时文件夹（就是你看到的C:\Users\Username\AppData\Local\Temp\_MEIxxxx），然后在这个临时目录里执行你的脚本。
• 这就导致你用__file__相关的方法（方法1、2、4）拿到的都是临时目录里的脚本路径，自然返回的是临时文件夹，不是你的项目根。
• 至于方法3，root_path(ignore_cwd=False)这个参数的意思是「不忽略当前工作目录」，也就是你打开终端运行exe时所在的文件夹，所以它返回的是终端的路径，不是项目根。

针对你的需求，这里提供几种实用的解决方法，你可以根据自己的场景选择：

方法1：通过sys.executable获取exe实际路径（最直接） #

打包后，sys.executable会指向你实际运行的那个exe文件的路径，而不是临时目录里的脚本。只要你的exe是放在项目根目录下的，用这个方法就能准确拿到根目录：

import os
import sys

def get_project_root():
    # 判断当前是否是打包后的运行环境
    if getattr(sys, 'frozen', False):
        # 打包后，sys.executable是exe文件的绝对路径
        exe_abspath = os.path.abspath(sys.executable)
        # 项目根目录就是exe文件所在的目录
        project_root = os.path.dirname(exe_abspath)
    else:
        # 开发环境下，用原来的方式获取根目录
        project_root = os.path.dirname(os.path.abspath(__file__))
    return project_root

# 测试
root = get_project_root()
print(root)

这个方法不需要修改打包命令，只要替换你原来的路径获取代码即可。

方法2：通过标志性文件自动识别根目录（更灵活） #

如果你的exe可能放在项目的子目录里，或者你想更鲁棒地识别根目录，可以在项目根目录下放置一个标志性文件（比如.project_root，或者你的main.py、requirements.txt这类只有根目录才有的文件），然后从当前路径往上查找，直到找到这个文件：

import sys
from pathlib import Path

def find_project_root():
    # 打包后用当前工作目录作为起点，开发环境用脚本所在目录
    start_path = Path.cwd() if getattr(sys, 'frozen', False) else Path(__file__).parent
    current_path = start_path

    # 向上遍历目录，直到找到标志性文件
    while current_path != current_path.parent:
        # 这里可以替换成你项目根目录独有的文件/文件夹
        if (current_path / ".project_root").exists() or (current_path / "main.py").exists():
            return current_path
        current_path = current_path.parent
    
    # 如果找不到，返回系统根目录作为兜底
    return current_path

# 测试
root = find_project_root()
print(root)

使用这个方法前，记得在你的项目根目录创建那个标志性文件（比如.project_root，可以是空文件）。

方法3：调整get_project_root的参数（针对第三方库） #

如果你想继续使用get_project_root库，可以尝试调整参数，但这个方法的可靠性取决于库的实现，不如前两种自定义方法稳定：

from get_project_root import root_path

# 设置ignore_cwd=True，让库忽略当前工作目录，从脚本路径向上查找
# 注意：打包后脚本在临时目录，可能需要结合其他逻辑才能拿到正确根目录
root_3 = root_path(ignore_cwd=True)
print(root_3)

如果你需要把项目中的资源文件（比如配置文件、图片）一起打包，记得在PyInstaller的spec文件中通过datas参数添加，比如：

# 在spec文件的Analysis部分修改datas
datas=[('config.ini', '.'), ('assets/', 'assets/')],

这样打包后，资源文件会被放到临时目录对应的位置，你可以通过sys._MEIPASS访问临时目录，结合我们获取的项目根目录来处理资源路径。

内容的提问来源于stack exchange，提问作者Mustafa_Asaad