#chinese#ffmpeg#subtitle#字幕

Ffmpeg Chinese Subtitle

Windows 上使用 ffmpeg 正确生成中文字幕的解决方案。用 Pillow 在图片上绘制字幕，ffmpeg 只负责图片转视频，完全避开编码问题。

Install

openclaw skills install @systiger/ffmpeg-chinese-subtitle

ffmpeg Chinese Subtitle

Windows 上使用 ffmpeg 正确生成中文字幕的解决方案。

问题背景

在 Windows 上使用 ffmpeg 的 drawtext、subtitles、ass 滤镜处理中文字幕时，会遇到以下问题：

错误码	原因
返回码 -22 (EINVAL)	字体路径转义问题
字幕不显示	中文编码被截断
乱码	字符集不匹配

解决方案

核心思路：用 Pillow 在图片上绘制字幕，ffmpeg 只负责图片转视频。

方案对比

方案	状态	原因
`drawtext=text='中文'`	❌ 失败	命令行参数截断
`subtitles='中文.srt'`	❌ 失败	路径编码问题
`ass='中文.ass'`	❌ 失败	同上
Pillow 绘制 + ffmpeg	✅ 成功	Python 原生支持 Unicode

快速使用

python

from ffmpeg_subtitle import add_subtitle_to_image

# 在图片上添加字幕
add_subtitle_to_image(
    image_path="input.png",
    subtitle_text="这是中文字幕",
    output_path="output.png",
    font_size=24,
    y_offset=50
)

参数说明

参数	默认值	说明
`image_path`	-	输入图片路径
`subtitle_text`	-	字幕文本
`output_path`	-	输出图片路径
`font_size`	24	字体大小
`y_offset`	50	距底部的偏移量（像素）
`font_color`	(255,255,255)	字体颜色 RGB
`shadow_color`	(0,0,0)	阴影颜色 RGB

依赖

text

Pillow>=10.0.0

字体

默认使用 Windows 系统字体：

主字体：C:/Windows/Fonts/msyh.ttc（微软雅黑）
备用字体：C:/Windows/Fonts/simhei.ttf（黑体）

触发词

ffmpeg字幕、中文字幕、视频字幕、字幕烧录

文件结构