PyInstaller打包内置git.exe的应用在无Git客户端运行import git报错

• 路径获取逻辑错误：os.getcwd()返回的是程序启动时的工作目录，不是exe自身的资源存放路径。用户从其他目录调用exe、通过快捷方式启动时，该路径会完全偏离实际资源位置，无法定位打包进去的git文件。
• PATH修改方式无效：os.system('SET PATH=...')只会修改临时启动的cmd子进程环境变量，不会改动当前Python进程的环境变量，GitPython初始化时读取当前进程环境变量，自然无法识别你加的路径。
• 打包内容不全：C:\Program Files\Git\cmd\git.exe只是启动引导程序，不是完整的Git程序，它依赖Git安装目录下bin、mingw64、usr目录里的大量dll和核心可执行文件，仅打包单个exe在未安装Git的设备上无法运行。
• 导入时机错误：GitPython在import git执行阶段就会检测git可执行文件位置，你之前的路径配置逻辑本身无效，导入时直接触发初始化报错。

1. 调整PyInstaller spec配置 #

补全Git运行所需的核心文件，同时补全GitPython相关的隐式导入：

# 替换为你本机的Git实际安装路径
GIT_ROOT = r'C:\Program Files\Git'
a = Analysis(['main.py'],
             pathex=[r'path\to\main.py'],
             binaries=[
                 (f'{GIT_ROOT}\\cmd\\git.exe', '.\\git\\cmd'),
                 (f'{GIT_ROOT}\\bin', '.\\git\\bin'),
                 (f'{GIT_ROOT}\\mingw64\\bin', '.\\git\\mingw64\\bin'),
                 (f'{GIT_ROOT}\\usr\\bin', '.\\git\\usr\\bin'),
             ],
             datas=[],
             hiddenimports=['win32timezone', 'git', 'gitdb', 'smmap'],
             hookspath=[],
             runtime_hooks=[],
             excludes=[],
             win_no_prefer_redirects=False,
             win_private_assemblies=False,
             cipher=block_cipher,
             noarchive=False)
pyz = PYZ(a.pure, a.zipped_data,
             cipher=block_cipher)
exe = EXE(pyz,
          a.scripts,
          [],
          exclude_binaries=True,
          name='sample_app',
          debug=False,
          bootloader_ignore_signals=False,
          strip=False,
          upx=True,
          console=True) 

如果需要控制包体积，可以删除打包后git目录下的git-gui、gitk、帮助文档、多语言资源等非核心文件，不影响基础git命令运行。

2. 修正代码中的路径与初始化逻辑 #

替换原有路径处理代码，放在所有git相关导入之前执行：

import os
import sys

# 获取程序真实运行路径，兼容开发环境与PyInstaller打包环境
if getattr(sys, 'frozen', False):
    app_base = os.path.dirname(sys.executable)
else:
    app_base = os.path.dirname(os.path.abspath(__file__))

# 拼接git.exe的完整路径
git_exe = os.path.join(app_base, 'git', 'cmd', 'git.exe')

# 直接修改当前进程的环境变量，无需调用cmd命令
os.environ['GIT_PYTHON_GIT_EXECUTABLE'] = git_exe
os.environ['PATH'] = os.path.dirname(git_exe) + os.pathsep + os.environ['PATH']
os.environ['GIT_PYTHON_REFRESH'] = 'quiet' # 关闭初始化警告

# 环境变量配置完成后再导入GitPython
import git
git.refresh(git_exe) # 显式指定git路径，兜底避免PATH查找失败

3. 验证注意事项 #

• 重新打包前先删除旧的build、dist目录，避免缓存文件导致打包内容不全
• 功能验证请在未安装Git的干净Windows环境（虚拟机、全新测试机）中进行，避免开发机全局安装的Git干扰测试结果
• 如果运行时提示缺少dll依赖，用Dependencies工具查看打包的git.exe缺失的依赖项，从本机Git安装目录中补到对应打包路径即可

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