简介：这是一份面向多媒体开发者的FFmpeg HEVC编解码实战示例，聚焦H.265这一高效节省带宽的高清视频编码标准，帮助读者理解解复用、解码、编码、Packet处理与输出写入的完整链路。资源包共1个文件，为单个C源码文件，压缩包约6KB，核心内容围绕解复用、解码、编码、数据包处理与输出写入等关键环节展开，涉及avformat_open_input、avcodec_find_decoder、avcodec_encode_video2、av_interleaved_write_frame等接口的调用逻辑，适合具备一定音视频基础、希望深入掌握FFmpeg处理H.265流程的开发者参考。目前已有9982人学习下载，可作为开发多媒体应用或进行视频处理时的实践参照，帮助读者梳理编解码流程、理解关键函数职责，并在此基础上优化带宽使用与提升高清视频处理体验。
1. 从一次“压完反而更大”的翻车说起：h265 编解码到底解决什么问题
有个做安防回传的读者找我，说他用 ffmpeg 把一批 1080p 监控片段转成 h265，结果文件比原来的 h264 还大了一圈，画质还糊了。这不是 h265 不行，而是他把-crf当成了“越小越好”的开关，又没管-preset，编码器在默认参数下根本没发挥出优势。h265（HEVC）相比 h264，同画质下码率通常能省 30% 到 50%，但前提是参数得配对。这份资源就是围绕“用 ffmpeg 调 libx265 做高清视频编解码”整理的实例集合，覆盖转码、切片、封装、硬解播放这几条链路。适合手里有高清素材、想压体积又不想明显掉画质的人，也适合需要把 h265 接入现有转码流水线的后端。下面按“先跑通、再调优、最后避坑”的顺序拆。
2. 环境准备与最小可跑实例：先把一条命令跑通
2.1 确认 ffmpeg 是否带 libx265
很多人卡在第一步：系统自带的 ffmpeg 根本没编进 libx265，跑命令直接报Unknown encoder 'libx265'。先查编码器列表，别急着转码。
# 查看当前 ffmpeg 是否支持 h265 软编 ffmpeg -hide_banner -encoders | grep -i 265 # 期望输出里能看到： # V....D libx265 libx265 H.265 / HEVC (codec hevc) # 如果只有 hevc 而没有 libx265，说明是硬编或系统解码器，不是软编逻辑说明：-encoders列出所有可用编码器，grep -i 265过滤出 h265 相关项。libx265是软编，兼容性最好、参数最全；hevc_nvenc、hevc_qsv、hevc_videotoolbox分别是 N 卡、Intel 核显、苹果平台的硬编，速度快但参数少、画质调优空间小。参数上，-hide_banner只是去掉版权横幅，不影响结果。如果查不到 libx265，常见做法是换用带完整编码器的构建版本，或者用系统包管理器装ffmpeg的完整包。
2.2 一条最小转码命令
先别上复杂参数，用最朴素的命令确认链路能通。
# 把 h264 的 mp4 转成 h265，音频直接复制不重编 ffmpeg -i input_h264.mp4 \ -c:v libx265 \ -crf 28 \ -preset medium \ -c:a copy \ output_h265.mp4逻辑说明：-i指定输入；-c:v libx265指定视频用 libx265 编码；-crf 28是恒定质量模式，数值越小画质越好、体积越大，h265 常用区间是 24 到 32；-preset medium控制编码速度与压缩率的平衡，越慢压缩率越高；-c:a copy表示音频流不重新编码，直接封装过去，省时间也避免音质二次损失。跑完对比一下体积和肉眼观感，心里先有个基准。这一步跑不通，后面调优都是空谈。
2.3 用 ffprobe 验证编码结果
转完不能只看文件大小，得确认它真的是 h265。
# 查看输出文件的视频流编码格式 ffprobe -v error -select_streams v:0 \ -show_entries stream=codec_name,width,height,bit_rate \ -of default=noprint_wrappers=1 output_h265.mp4逻辑说明：-select_streams v:0只选第一条视频流；-show_entries stream=...指定要输出的字段；codec_name应该显示hevc。如果显示的还是h264，说明命令里编码器没生效，多半是被某个默认参数覆盖了。bit_rate字段能帮你判断实际码率落在什么区间，和源文件对比就知道省了多少。
3. 参数调优：crf、preset、profile 怎么配才不翻车
3.1 crf 与 preset 的取舍
crf 决定画质下限，preset 决定编码耗时和压缩效率。这两个是 h265 转码里最核心的旋钮，配错了就是开头那位读者的翻车现场。
| 参数 | 常用取值 | 影响 | 适用场景 |
|---|---|---|---|
| -crf | 24 / 28 / 32 | 越小画质越好体积越大 | 24 存档，28 通用，32 预览 |
| -preset | fast / medium / slow | 越慢压缩率越高耗时越长 | fast 批量，slow 精品 |
| -profile:v | main / main10 | main10 支持 10bit | 10bit 素材必须 main10 |
| -tag:v | hvc1 | 苹果生态兼容 | 需要 QuickTime 播放时加 |
我一般会先用-crf 28 -preset medium跑一条样片，看体积和观感，再决定往哪个方向调。想再省体积就升 preset 到 slow，想保画质就降 crf 到 24。别同时把 crf 压到 20 以下又用 fast，那样体积会失控。
3.2 10bit 与 profile 的坑
高清素材里 10bit 越来越常见，尤其是 HDR 或专业摄像机出来的。如果源是 10bit，编码时没指定 main10，会被强制降到 8bit，暗部直接出现色带。
# 10bit 素材转码，显式指定 main10 ffmpeg -i input_10bit.mov \ -c:v libx265 \ -crf 24 \ -preset slow \ -profile:v main10 \ -pix_fmt yuv420p10le \ -c:a copy \ output_10bit.mp4逻辑说明：-profile:v main10告诉编码器用 10bit 档次；-pix_fmt yuv420p10le指定像素格式为 10bit 的 YUV 4:2:0。这两个要配套，只写 profile 不写 pix_fmt，或者反过来，都可能被编码器忽略。参数上，10bit 的 crf 可以比 8bit 略高一点，因为色深本身容错更好，我常用 24 到 26。
3.3 批量转码的脚本写法
单条命令跑通后，实际工作往往是整目录批量处理。用 shell 循环最直接，但要注意文件名里的空格和特殊字符。
#!/bin/bash # 批量把当前目录下的 mp4 转成 h265，输出到 out 目录 mkdir -p out for f in *.mp4; do # 跳过已经是 hevc 的文件，避免重复转码 codec=$(ffprobe -v error -select_streams v:0 \ -show_entries stream=codec_name -of csv=p=0 "$f") if [ "$codec" = "hevc" ]; then echo "skip $f (already hevc)" continue fi ffmpeg -i "$f" \ -c:v libx265 -crf 28 -preset medium \ -c:a copy "out/${f%.mp4}_h265.mp4" done逻辑说明：ffprobe先探测编码格式，已经是 hevc 的跳过，省得白跑一遍还掉画质。${f%.mp4}是去掉扩展名再拼新名字。变量"$f"加引号是为了兼容带空格的文件名，这是批量脚本里最常见的翻车点。参数上，批量场景我一般用 medium，兼顾速度和体积，slow 留给单独的精修片。
4. 硬编与软编的边界：什么时候该换 hevc_nvenc
4.1 硬编的适用与限制
软编 libx265 画质好、参数全，但慢。一段 10 分钟的 4K 素材，medium 下可能要跑十几分钟甚至更久。如果只是做预览、代理文件，或者对时效要求高，硬编更合适。
# N 卡硬编 h265，速度快但参数少 ffmpeg -i input.mp4 \ -c:v hevc_nvenc \ -preset p5 \ -cq 28 \ -c:a copy \ output_nvenc.mp4逻辑说明：hevc_nvenc是 N 卡硬编；-preset p5是硬编自己的速度档，p1 最快 p7 最慢；-cq 28类似 crf，控制质量。注意硬编的 cq 和软编的 crf 不是一回事，数值不能直接照搬，得重新试。硬编的边界在于：同码率下画质通常不如软编，且对 10bit、特殊像素格式支持有限。我一般把硬编用在代理文件和直播转码，成片归档还是走 libx265。
4.2 解码端：硬解播放的兼容问题
编出来的 h265 能不能顺畅播，是另一回事。很多播放器对 h265 的封装标签敏感，尤其是苹果生态。
# 给 h265 流打上 hvc1 标签，提升苹果生态兼容性 ffmpeg -i input_h265.mp4 \ -c:v copy \ -tag:v hvc1 \ -c:a copy \ output_hvc1.mp4逻辑说明：-c:v copy表示视频流不重编，只改封装；-tag:v hvc1把 h265 的标签从默认的hev1改成hvc1。hev1和hvc1都是 h265 的合法标签，但部分播放器和系统只认hvc1。这一步不改变画质，只改容器里的标记，属于零成本兼容性修复。参数上，copy要求输入输出容器都支持 h265，mp4 和 mov 都行。
5. 避坑与排查：h265 转码里最容易踩的五个坑
5.1 转完体积反而变大
现象：h264 源转 h265 后文件更大。原因：crf 设得太低，或者源本身码率就很低，h265 在低码率下优势不明显，反而因为编码开销变大。解决：先看源码率，低于 1Mbps 的 1080p 素材，转 h265 收益有限；crf 从 28 起步，别一上来就 20。
5.2 播放器黑屏只有声音
现象：转出的 mp4 在部分播放器上黑屏。原因：h265 标签是hev1，播放器不认。解决：用-tag:v hvc1重封装一遍，不重编，几秒搞定。
5.3 10bit 素材出现色带
现象：暗部出现明显色带。原因：源是 10bit，编码时没指定 main10 和 10bit 像素格式，被降到 8bit。解决：加-profile:v main10 -pix_fmt yuv420p10le，并确认源确实是 10bit。
5.4 批量脚本遇到空格文件名报错
现象：循环跑到某个文件就中断。原因：文件名带空格，变量没加引号。解决：所有$f写成"$f"，ffprobe和ffmpeg的输入输出都加引号。
5.5 硬编画质明显发糊
现象：hevc_nvenc 出来的片子细节糊。原因：硬编的 cq 值没调好，或者用了过快的 preset。解决：cq 往低调，preset 往慢调，或者干脆换回 libx265。硬编适合赶时间，不适合抠画质。
6. 进阶技巧：用 two-pass 和分段编码把体积压到极限
前面讲的 crf 是恒定质量模式，胜在省心。但如果你的目标是“在指定体积内做到最好画质”，比如要卡一个上传大小限制，two-pass 更合适。它的思路是：第一遍分析画面复杂度，第二遍按目标码率分配。
# two-pass 把视频压到目标码率，适合有体积上限的场景 ffmpeg -y -i input.mp4 -c:v libx265 -b:v 1500k -x265-params pass=1 \ -an -f null /dev/null ffmpeg -i input.mp4 -c:v libx265 -b:v 1500k -x265-params pass=2 \ -c:a copy output_2pass.mp4逻辑说明：第一遍-an去掉音频、-f null /dev/null不产出实际文件，只生成统计信息；-x265-params pass=1告诉 x265 这是第一遍。第二遍pass=2才真正编码。-b:v 1500k是目标码率，两遍必须一致。参数上，two-pass 比 crf 慢将近一倍，但体积可控，适合有硬性大小要求的交付。
另一个技巧是分段编码再拼接。超长视频一次性编码，中途出错就得重来，内存和临时文件压力也大。我一般按时间切成几段分别编，最后用 concat 合并。
# 按时间切段，每段单独编码 ffmpeg -ss 00:00:00 -t 00:10:00 -i long.mp4 \ -c:v libx265 -crf 28 -preset medium -c:a copy part1.mp4 ffmpeg -ss 00:10:00 -t 00:10:00 -i long.mp4 \ -c:v libx265 -crf 28 -preset medium -c:a copy part2.mp4 # 用 concat demuxer 合并，注意要同编码参数 printf "file 'part1.mp4'\nfile 'part2.mp4'\n" > list.txt ffmpeg -f concat -safe 0 -i list.txt -c copy merged.mp4逻辑说明：-ss放在-i前面是快速定位，比放后面快很多；-t指定每段时长。分段编码的关键是各段参数必须完全一致，否则 concat 出来的文件在切换点会花屏或音画不同步。-safe 0允许 list 里用相对路径。这套流程我用了很久，最大的好处是某段翻车只重跑那一段，不用整条重来。
从那以后我每次批量转码前，都强制先拿一条 30 秒样片跑一遍完整参数，确认体积、画质、播放兼容性都没问题，再放开跑全量。这个习惯帮我省过好几次“跑了一晚上发现参数错了”的后悔药。希望帮到你。
本文还有配套的精品资源，点击获取
