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