如何通过PyInstaller打包ffmpeg至可执行文件并解决路径缺失问题？

1. 修改入口文件 cli.py #

在cli.py最开头添加路径处理逻辑，将PyInstaller打包的ffmpeg所在目录临时加入当前进程的PATH环境变量，第三方代码无需修改就能找到ffmpeg：

import os
import sys

def get_packaged_bin_path(relative_dir):
    try:
        # 单文件模式下，PyInstaller会将资源解压到sys._MEIPASS指向的临时目录
        base_dir = sys._MEIPASS
    except AttributeError:
        # 开发环境下使用当前工作目录
        base_dir = os.path.abspath(".")
    return os.path.join(base_dir, relative_dir)

# 获取打包后ffmpeg所在的bin目录
ffmpeg_bin_path = get_packaged_bin_path("bin")

# 将该目录插入到PATH最前端，确保优先调用打包的ffmpeg
os.environ["PATH"] = f"{ffmpeg_bin_path}:{os.environ['PATH']}"

# 此处导入并执行你的主程序逻辑（比如原来cli.py的内容）
# 示例：from your_core_logic import run
# run()

2. 保持PyInstaller命令不变 #

你的原有打包命令已经正确指定了ffmpeg的打包路径，无需修改：

pyinstaller cli.py \
  --onefile \
  --add-binary /Users/<machineUser>/anaconda3/envs/my_env/bin/ffmpeg:bin

原理说明 #

• sys._MEIPASS是PyInstaller单文件模式下自动生成的临时目录路径，程序运行时会将打包的资源解压到这里，程序退出后该临时目录会被自动删除，完全符合无残留要求。
• 修改os.environ["PATH"]仅作用于当前程序进程，不会修改系统全局环境变量，程序结束后环境自动恢复。
• 将打包的bin目录放到PATH最前端，确保第三方代码调用ffmpeg命令时，优先找到我们打包的版本，而非系统或其他conda环境中的版本。

验证 #

在base环境中直接运行生成的可执行文件即可正常调用ffmpeg：

(base) machineUser folder % "dist/cli_mac_001202312051431" ./testFile202312061352.mp4

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