视频转 GIF 动图失败、卡住或结果不对？排错指南
按编码、容器、参数、内存和浏览器顺序排查视频转 GIF 动图，并理解转码质量与设备边界。
不要改后缀冒充格式
媒体扩展名只是容器名称，不代表内部视频、音频编码一定受支持。保留原文件，记录文件大小、时长、编码、分辨率、浏览器和完整错误；不要反复覆盖唯一原件。
本工具最容易忽略的问题
例如先用视频剪切工具准备一段 4 秒短视频，再在本页设置 480 像素宽、12 fps 和较少颜色。本页转换完整输入，不提供起止截取。
推荐排查顺序
- 用很短、分辨率较低的已知正常样本确认工具能够加载。
- 检查页面是否读到时长、视频轨、音频轨和尺寸；读不到通常是损坏或编解码器不支持。
- 减少时长、分辨率、帧率或同时处理的文件数量。
- 关闭其他大型标签页，用最新版桌面 Chrome/Edge 重试并保持页面前台。
- 对照以下步骤重新设置：
- 选择已经截短的 MP4、MOV 或 WebM，并确认时长。
- 设置 GIF 宽度、帧率和颜色数量。
- 开始转换完整视频。
- 检查动画节奏、清晰度和体积后下载。
- 仍失败时使用桌面 FFmpeg 或创建该文件的专业软件，不要宣称网页支持该编码。
参数检查
- 宽度：降低可显著减少体积
- 帧率：常用 8–15 fps
- 颜色数量：越少越小，但色带更明显
常见错误
为什么 GIF 比视频还大？
GIF 压缩效率远低于现代视频；缩短时长、尺寸、帧率和颜色数量。
为什么没有声音？
GIF 格式不支持音频。
视频会上传吗？
媒体文件只在当前浏览器标签页中读取和转码，不会为了运行该工具上传到 FreeTool 服务器。
无法绕过的边界
- GIF 不保留声音
- 长片段、高分辨率和高帧率会非常慢且体积大
- 输入容器可识别不代表其中每种编解码器都受支持
浏览器 WASM 没有原生应用的全部性能和编解码器，长视频可能耗时很久。进度暂时不变化不等于服务器上传；处理发生在当前标签页，但浏览器仍可能因为内存压力终止任务。
隐私、版权与开源许可证
媒体文件只在当前浏览器标签页中读取和转码，不会为了运行该工具上传到 FreeTool 服务器。 排错截图和输出文件仍可能包含隐私、受版权保护内容或隐藏 metadata，分享前要检查。ffmpeg.wasm wrapper 为 MIT；本期 FFmpeg core 为 GPL-2.0-or-later，不能删除源代码获取方式与许可证 Notice。