windows cmd 中调用 FFmpeg 命令的注意事项

2025-07-04 18:21:05 5 分享链接开发笔记 ffmpeg cmd

FFmpeg在Windows命令提示符中的正确使用方法

在Windows命令提示符(CMD)中使用FFmpeg时，需要特别注意参数格式和引号的使用，以避免解析错误。以下是详细的使用指南：

1. 基本命令格式

FFmpeg命令通常由以下部分组成：

ffmpeg -i 输入文件 -选项 输出文件

输入文件：使用 -i 指定，例如 input.mp4
选项：如视频滤镜(-vf)、音频编码(-c:a)等
输出文件：如 output.mp4

2. 特殊字符处理

Windows CMD对以下字符敏感，需要特殊处理：

空格：参数中包含空格时，需用双引号包裹
```
ffmpeg -i "C:\Videos\My File.mp4" -c:v copy output.mp4
```

反斜杠(\)：路径中的反斜杠需用双反斜杠(\\)或正斜杠(/)代替

# 正确：使用双反斜杠
fontfile='C:\\Windows\\Fonts\\simhei.ttf'

# 更简单：使用正斜杠（Windows支持）
fontfile='C:/Windows/Fonts/simhei.ttf'

冒号(:)：在滤镜参数中，冒号用于分隔键值对，需确保路径中的冒号不被误解析

# 错误：会被解析为多个参数
fontfile=C:\Windows\Fonts\simhei.ttf

# 正确：转义驱动器号后的冒号
fontfile=C\\:Windows\\Fonts\\simhei.ttf

3. 视频滤镜(`-vf`)的引号规则

滤镜参数通常包含多个子参数，需使用引号包裹整个滤镜链。在Windows CMD中：

整体用双引号包裹：-vf "滤镜1,滤镜2"
内部参数用单引号：如 force_style='参数=值'

避免嵌套引号冲突：

# 错误：嵌套引号导致解析错误
-vf "drawtext=text='测试标题':fontfile='C:\Fonts\simhei.ttf'"

# 正确：移除text的引号，使用双反斜杠路径
-vf "drawtext=text=测试标题:fontfile=C\\:Fonts\\simhei.ttf"

# 或使用单引号包裹路径
-vf "drawtext=text=测试标题:fontfile='C:/Fonts/simhei.ttf'"

4. 常见场景示例

添加字幕和文字水印

ffmpeg -i input.mp4 -vf "scale=1080:1920,subtitles=test.srt:original_size=1080x1920:force_style='FontSize=12,Alignment=2,MarginV=200',drawtext=text=测试标题:fontfile=C\\:Windows\\Fonts\\simhei.ttf:fontsize=48:fontcolor=yellow:x=470:y=200" -c:v h264_nvenc -y output.mp4

调整视频尺寸并添加水印

ffmpeg -i input.mp4 -vf "scale=1280:720,drawtext=text='©水印':fontfile=C\\:Windows\\Fonts\\simhei.ttf:fontsize=24:fontcolor=white:x=10:y=10" -c:v libx264 -crf 23 -y output.mp4

5. 故障排除

错误提示 No option name near...：通常是引号或路径格式错误，检查：
1. 路径是否使用了正确的斜杠（/ 或 \\）
2. 是否有未闭合的引号
3. 是否在滤镜参数中错误使用了冒号
中文字符显示问题：确保CMD的代码页设置为UTF-8（执行 chcp 65001）