3 分钟修好打不开的 MP4：用 untrunc 无损救回视频的完整指南-开发者社区

3 分钟修好打不开的 MP4：用 untrunc 无损救回视频的完整指南

【免费下载链接】untruncRestore a truncated mp4/mov. Improved version of ponchio/untrunc项目地址: https://gitcode.com/gh_mirrors/un/untrunc

相机拍完没有报任何错，回到家打开文件却提示"已损坏"；一段会议录像拖进播放器，画面闪了两下就卡死。如果里面是不可重拍的回忆或数据，你会想立刻试试开源工具untrunc——它专门修复损坏、截断的 MP4、MOV、M4V、3GP 视频：不重新编码，靠一个"健康参考视频"给损坏文件重新做一份目录，把画面原封不动地救回来。

🎯 它到底能救谁、救不了谁

先花 10 秒判断你的文件值不值得修，能省不少时间。

能救的情况：

目录损坏：录制中突然断电、拔卡，文件的"目录"（moov 原子）没写完或写坏了，但画面数据还在。这是最常见、也最好修的一类。
文件截断：传输中断、下载不完整，文件只有"前半截"。
结构错乱：原子长度异常、未知数据块混入（工具专门处理过这类脏结构）。

救不了的情况：

存储介质物理损坏：卡有坏块、盘片划伤，数据本身读不出来。
编码数据严重错误：画面数据块本身就坏了，工具只能重做目录，补不出丢失的画面。

一个实用判断：如果损坏文件的大小接近正常文件、且能隐约看到内容，多半是"目录坏了、身体还在"，值得一试；如果文件小得离谱或完全读不出，先备份原件，再考虑专业数据恢复服务。

✅ 动手前，先做这 3 项自检

untrunc 修复成功的核心前提：找到一个健康的参考视频。它拿这个视频当"模板"，所以两者越像，成功率越高。对照下面清单打钩：

同一台设备：最好来自同一台相机、手机或摄像机。不同设备的参考，成功率会明显下降。
相同录制参数：分辨率、帧率、编码格式（H.264/HEVC）一致。
相同文件格式：MP4 配 MP4、MOV 配 MOV，别拿 .m4v 去修 .mov。
录制时间相近：同批次、同固件时期录的视频，编码器行为最接近。

三项都能勾上，再往下做；勾不上也不必放弃，只是预期要放低一些。

🚀 三分钟出结果：从安装到修完

第一步：装好工具

Windows：直接下载项目发布页提供的预编译版本，解压即可用，无需配置。

Linux（Debian/Ubuntu）：

# 安装 FFmpeg 开发库并编译 sudo apt-get install libavformat-dev libavcodec-dev libavutil-dev git clone https://gitcode.com/gh_mirrors/un/untrunc cd untrunc && make sudo cp untrunc /usr/local/bin

macOS：

# 用 Homebrew 准备依赖后编译 brew install ffmpeg yasm export PKG_CONFIG_PATH="/opt/homebrew/lib/pkgconfig" CPPFLAGS="-I/opt/homebrew/include" LDFLAGS="-L/opt/homebrew/lib" make

第二步：执行修复

只需一条命令，参数顺序是先健康视频、后损坏视频：

# 用健康视频当模板，修复损坏视频 untrunc healthy_video.mp4 broken_video.mp4

第三步：拿到结果

成功后会在损坏文件旁边生成一个新文件：broken_video_fixed.mp4。原始损坏文件不会被改动，你可以放心反复尝试。

📺 确认修复成功的 3 个信号

生成_fixed.mp4不等于万事大吉，用播放器打开新文件，依次确认：

能打开、能起播：用常规播放器（VLC、系统自带都行）打开，不报"文件已损坏"。
时长完整：总时长接近你预期的录制时长，结尾没有戛然而止、没有大段空白。
音画同步、无异常：从头到尾完整播放一遍，声音和画面对齐，中途无花屏、无卡死。

三条都满足，可以认为修复成功，立即把新文件备份。如果只能播放开头几秒、或中途报错停止，多半是参考视频匹配度不够——换一条更接近的参考视频再试，或进入下一节加诊断参数。

📈 把成功率再往上拉

基础命令不行时，按场景选参数：

场景：输出看不懂，想知道卡在哪加-v开启详细日志，会打印出结构分析的完整过程。
```
untrunc -v healthy.mp4 broken.mp4
```
场景：想把结果存到指定位置、或改个文件名用-dst指定输出目录或文件名，避免和一堆_fixed文件混在一起。
```
untrunc -dst restored.mp4 healthy.mp4 broken.mp4
```
场景：修好了但音画时长对不上加-sv（beta 功能）让视频时长向音频对齐，解决"音频播完了视频还在放"这类问题。
```
untrunc -sv healthy.mp4 broken.mp4
```
场景：不想折腾编译环境，或想隔离运行项目自带 Dockerfile，一条命令构建、一条命令修复：
```
docker build -t untrunc . docker run --rm -v ~/Videos/:/mnt untrunc /mnt/healthy.mp4 /mnt/broken.mp4
```

⚙️ 30 秒看懂它是怎么修的

MP4 这类文件由一个个"原子"（block）拼成：moov是目录，记录"第几帧数据在第几字节"；mdat是正文，装着真正的画面数据。断电、拔卡这类事故，通常毁掉的是目录，正文还完整躺在文件里。

untrunc 做的事就三步：读健康视频的目录结构当模板 → 在损坏文件里按模板扫描出数据块 → 重写一份新目录并输出新文件。

因为只重写目录、不碰画面数据，所以修复后的视频画质和原始完全一致，不存在任何重编码损失。核心逻辑在src/mp4.cpp，H.264/HEVC 的编码解析分别在src/avc1/和src/hvc1/；怕命令行的话，图形界面版本在src/gui/，Windows 预编译包默认就带。

🩹 报错速查表

现象	可能原因	一步解法
修完的文件仍打不开	参考视频编码参数不匹配，或数据块没被扫到	按自检清单换一条更接近的参考视频；还不行就试`untrunc -sm healthy.mp4 broken.mp4`强制搜索媒体数据
内存占用过高、进程被系统杀掉	文件过大，资源不够	先用`untrunc -dw healthy.mp4 broken.mp4`（只分析、不写文件）确认结构能对上，再正式修复；或用 Docker 方式隔离运行
修复后音画不同步	时间戳信息受损，视频与音频时长对不齐	加`-sv`让视频向音频时长对齐：`untrunc -sv healthy.mp4 broken.mp4`
找不到合适的参考视频	手上没有同设备同参数的视频	找同相机同分辨率/帧率的旧视频（哪怕很短）；实在没有，成功率会很低，考虑专业数据恢复
终端提示找不到命令 untrunc	没编译完，或不在系统路径	重新执行`make`确认编译成功；或改用完整路径`./untrunc ...`调用