当前位置：首页 > news >正文

pyinstaller打包的时候将ffmpeg也加进包中（包括打包文件夹的方法）

news 2025/7/7 17:03:06

在使用 PyInstaller 打包包含 pydub 的 Python 应用程序时，由于 pydub 需要依赖 ffmpeg，你需要确保 ffmpeg 被正确包含进打包后的程序。以下是操作步骤：

1. 准备 `ffmpeg`

首先，确保你已经下载并安装了 ffmpeg。可以通过以下方式获取：
- Windows：从 FFmpeg 官网下载预编译的二进制文件，并将其解压。
- Linux/MacOS：可以通过包管理器（如 apt 或 brew）安装：
```
sudo apt install ffmpeg   # Linux
brew install ffmpeg       # MacOS
```
注意：需要记录下 ffmpeg 的路径，因为稍后需要将其包括在打包中。

2. 使用 PyInstaller 打包并包含 `ffmpeg`

PyInstaller 的默认行为不会自动包括外部的可执行文件，因此你需要显式指定 ffmpeg。

方法 1：使用 PyInstaller 的 `--add-binary` 参数

假设 ffmpeg 的路径是 path/to/ffmpeg，使用以下命令打包：

pyinstaller --onefile --add-binary "path/to/ffmpeg:./" your_script.py

--add-binary 的格式为：源路径:目标路径。
- 这里 path/to/ffmpeg 是 ffmpeg 的实际路径。
- ./ 表示将 ffmpeg 放到打包后的可执行文件同目录下。

打包完成后，可执行文件运行时会在同目录找到 ffmpeg。

方法 2：修改 `PyInstaller` 的规范文件（更灵活）

生成 .spec 文件：

pyinstaller --onefile --name your_script your_script.py

编辑生成的 .spec 文件，在 binaries 部分添加 ffmpeg：

a = Analysis(...binaries=[('path/to/ffmpeg', './')],  # 添加这行...
)

使用 .spec 文件重新打包：
```
pyinstaller your_script.spec
```

3. 确保运行时 `pydub` 能找到 `ffmpeg`

在代码中显式指定 ffmpeg 的路径（推荐），避免路径问题导致 pydub 找不到 ffmpeg。可以在脚本中加上以下代码：

from pydub import AudioSegment
from pydub.utils import which# 显式指定 ffmpeg 的路径
AudioSegment.converter = which("ffmpeg") or "path/to/ffmpeg"

参考spec文件如下：

# -*- mode: python ; coding: utf-8 -*-a = Analysis(['server.py'],pathex=[],binaries=[("./ffmpeg.exe","./ffmpeg.exe")],datas=[("./prompts","prompts"),('./logo.ico','.')],  hiddenimports=[],hookspath=[],hooksconfig={},runtime_hooks=[],excludes=[],noarchive=False,optimize=0,
)
pyz = PYZ(a.pure)exe = EXE(pyz,a.scripts,a.binaries,a.datas,[],name='server',debug=False,bootloader_ignore_signals=False,strip=False,upx=True,upx_exclude=[],runtime_tmpdir=None,console=True,disable_windowed_traceback=False,argv_emulation=False,target_arch=None,codesign_identity=None,entitlements_file=None,icon=['logo.ico'],
)

注1：prompts是文件，我的一些资源基本都放进这个文件夹。
不过文件读取的时候需要注意一点,文件的路径不能直接用相对路径这会报not such file or directory的错误。
注2：如果使用到ffmpeg，还报错。可以添加进路径中不直接使用，比如你是如果是pydub就可以在开头加二行代码

from pydub.utils import which
# 显式指定 ffmpeg 的路径
AudioSegment.converter = which("ffmpeg")

# 获取当前程序所在的路径
if getattr(sys, 'frozen', False):# 如果是打包后的程序，使用临时目录路径base_path = sys._MEIPASS
else:# 如果是开发环境，使用当前脚本所在路径base_path = os.path.dirname(__file__)# 拼接文件的绝对路径
file_path = os.path.join(base_path, 'prompts', '晓语systemPrompt_.txt')
with open(file_path, encoding='utf-8') as r:systemprompt = '\n'.join(r.readlines())memory.append({'role':'system','content':systemprompt})