关键在于ffmpeg.exe被系统和Python同时稳定识别：需确保PATH中路径无空格/中文、添加后重启终端、用where ffmpeg和shutil.which('ffmpeg')双重验证，subprocess调用必须加check=True、stdout/stderr=PIPE、text=True、timeout参数，禁用shell=True。
直接能用的 FFmpeg + Python 音视频处理环境，在 Windows 上不是“装了就能跑”，关键在于 ffmpeg.exe 能被系统和 Python 同时稳定识别——90% 的失败都卡在这一步，不是 Python 写错了，是路径或权限没对上。
确认 ffmpeg.exe 是否真在 PATH 里
很多人执行 ffmpeg -version 成功，就以为万事大吉，但 Python 调用时仍报 FileNotFoundError: [WinError 2] 系统找不到指定的文件。这是因为：
- PowerShell 或 CMD 中能运行，不代表 Python 的
subprocess进程能继承同一套环境变量（尤其用了虚拟环境、IDE 内置终端、或未重启终端） - PATH 中路径含空格或中文（如
C:\Program Files\ffmpeg\bin）会导致subprocess解析失败 - 添加环境变量后没开新终端验证，旧窗口 PATH 未刷新
实操建议：
- 在命令行中运行
where ffmpeg（不是which），确认返回唯一、干净的路径，如C:\dev_tools\ffmpeg\bin\ffmpeg.exe - 在 Python 中加一行诊断代码：
import shutil; print(shutil.which('ffmpeg'))，输出必须是非None的绝对路径 - 如果返回
None，别改 Python 代码绕过，直接修正系统 PATH：右键“此电脑”→属性→高级系统设置→环境变量→编辑“系统变量”里的Path→新增一行，只填C:\dev_tools\ffmpeg\bin（不含ffmpeg.exe）
Python 调用时避免 subprocess.run() 报错的关键参数
用 subprocess.run() 执行 FFmpeg 命令，看似简单，但漏掉几个参数就会静默失败或卡死：
立即学习“Python免费学习笔记（深入）”；
-
check=True必须加，否则错误码不触发异常，你根本不知道转码失败了 -
stdout=subprocess.PIPE和stderr=subprocess.PIPE要配对使用，否则进程可能因缓冲区满而阻塞（尤其处理长视频时） -
text=True推荐开启，让stdout/stderr返回字符串而非字节，方便日志打印和错误提取 - 不要用
shell=True，Windows 下它会启动 cmd.exe，引入额外解析层，路径空格、引号容易出错；坚持用列表传参，如['ffmpeg', '-i', r'C:\video\test.mp4', '-vn', 'out.mp3']
示例最小可靠调用：
import subprocess
result = subprocess.run(
['ffmpeg', '-i', 'input.mp4', '-vn', '-acodec', 'libmp3lame', 'output.mp3'],
check=True,
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
text=True,
timeout=300 # 防止无限挂起
)Windows 下常见设备名与 dshow 参数陷阱
想录屏或采集系统声音？FFmpeg 在 Windows 依赖 DirectShow（-f dshow），但设备名不是固定字符串，不同机器、驱动、甚至系统语言都可能不同：
-
立体声混音在英文系统叫stereo mix，某些 Realtek 声卡显示为What U Hear，部分主板默认禁用 - 屏幕捕获设备名可能是
screen-capture-recorder（需额外安装）、desktop（旧版）或gdigrab（推荐，无需额外驱动） - 直接硬写设备名会报错：
Invalid argument或Cannot find a valid device
实操建议：
- 先用命令探测可用设备：
ffmpeg -list_devices true -f dshow -i dummy，结果在stderr里，注意看 “DirectShow video devices” 和 “audio devices” 区块 - 录屏优先用
-f gdigrab（Windows 自带）：['ffmpeg', '-f', 'gdigrab', '-i', 'desktop', '-framerate', '30', 'out.mp4'] - 录系统声音必须启用并选对音频设备，且右键该设备属性 → 取消勾选“允许应用程序独占控制此设备”
ffmpeg-python 库的定位与真实价值
很多人装了 ffmpeg-python 就以为可以不用碰命令行了，其实它只是个“命令生成器+封装器”，底层依然调用 ffmpeg.exe。它的优势不在替代，而在结构化构建复杂参数：
- 适合多 filter 链、动态拼接选项（如根据分辨率自动选 preset）、批量任务编排
- 不解决环境配置问题：如果
shutil.which('ffmpeg')是None，ffmpeg-python一样报错 - 它的
.run()方法本质还是subprocess.run()，参数陷阱一个不少，只是语法糖更厚 - 初学者慎用
global_args或自定义ffmpeg_path，容易覆盖 PATH 查找逻辑，反而更难调试
一句话：它省的是“拼字符串”的事，不是“配环境”的事。先确保裸 subprocess 能跑通，再考虑是否上 ffmpeg-python。
最易被忽略的一点：FFmpeg 的 bin 目录里除了 ffmpeg.exe，还有 ffprobe.exe 和 ffplay.exe。很多脚本依赖 ffprobe 提取元数据，如果只把 ffmpeg.exe 拷出来单独放，ffprobe 找不到照样失败——PATH 指向的必须是完整 bin 目录，不是单个 exe 文件。
