视频画面裁剪失败、卡住或结果不对？排错指南
按编码、容器、参数、内存和浏览器顺序排查视频画面裁剪，并理解转码质量与设备边界。
不要改后缀冒充格式
媒体扩展名只是容器名称，不代表内部视频、音频编码一定受支持。保留原文件，记录文件大小、时长、编码、分辨率、浏览器和完整错误；不要反复覆盖唯一原件。
本工具最容易忽略的问题
例如横屏素材裁成 9:16，需拖动时间轴检查主体是否始终在框内。当前固定裁剪不会自动跟踪移动人物。
推荐排查顺序
- 用很短、分辨率较低的已知正常样本确认工具能够加载。
- 检查页面是否读到时长、视频轨、音频轨和尺寸；读不到通常是损坏或编解码器不支持。
- 减少时长、分辨率、帧率或同时处理的文件数量。
- 关闭其他大型标签页，用最新版桌面 Chrome/Edge 重试并保持页面前台。
- 对照以下步骤重新设置：
- 选择视频并读取原始宽高。
- 输入裁剪 X、Y、宽度和高度。
- 设置画质与音频码率并开始处理。
- 检查实际裁剪边界、主体位置与输出分辨率。
- 仍失败时使用桌面 FFmpeg 或创建该文件的专业软件，不要宣称网页支持该编码。
参数检查
- 裁剪 X
- 裁剪 Y
- 裁剪宽度
- 裁剪高度
- 画质 / CRF
- 音频码率
常见错误
为什么主体后面跑出画面？
当前是固定区域裁剪，不进行人物或物体跟踪。
为什么边界差一像素？
编码像素格式常要求偶数边界，实际值会做安全对齐。
视频会上传吗？
媒体文件只在当前浏览器标签页中读取和转码，不会为了运行该工具上传到 FreeTool 服务器。
无法绕过的边界
- 裁掉区域无法从输出恢复
- 当前没有拖动画框、比例预设或主体跟踪
- 裁剪坐标必须在源画面范围内且宽高为偶数
浏览器 WASM 没有原生应用的全部性能和编解码器，长视频可能耗时很久。进度暂时不变化不等于服务器上传；处理发生在当前标签页，但浏览器仍可能因为内存压力终止任务。
隐私、版权与开源许可证
媒体文件只在当前浏览器标签页中读取和转码，不会为了运行该工具上传到 FreeTool 服务器。 排错截图和输出文件仍可能包含隐私、受版权保护内容或隐藏 metadata，分享前要检查。ffmpeg.wasm wrapper 为 MIT；本期 FFmpeg core 为 GPL-2.0-or-later，不能删除源代码获取方式与许可证 Notice。