HandBrakeCLI 1.11.2：Windows PowerShell 编码与扫描检查

HandBrakeCLI 1.11.2 Windows 教程说明如何从官方版本包启动命令行、转码 MP4 并扫描输出，适合需要复核编码结果的 PowerShell 用户；示例范围限于合成短片实测，不承诺通用压缩率。文内区分命令返回与播放器检查，并提示使用新文件名保留原片，同时说明质量参数须按编码器调整。

目标

配图待补：需提供该操作对应的 1.11.2 Windows CLI 真实截图，并记录来源、授权、版本与加载检查；当前没有合适的已授权截图。

在 Windows PowerShell 中调用 HandBrakeCLI 1.11.2 编码视频并扫描输出。实测只覆盖合成短片的 CLI 编码与扫描，不代表 GUI、真实素材效果或通用压缩率。

关联软件：HandBrake 软件详情。

适用环境与版本

配图待补：需提供该操作对应的 1.11.2 Windows CLI 真实截图，并记录来源、授权、版本与加载检查；当前没有合适的已授权截图。

Windows x86_64，HandBrakeCLI 1.11.2。资产为 Windows x86_64 CLI ZIP。现存编码与扫描日志记录的实测环境为 Windows 10.0 (26200)；这是该次实测环境，不构成所有 Windows 版本均兼容的声明。本文不提供 GUI 按钮步骤。官方 1.11.2 发布说明（2026-06-07）列出编码、音频、字幕及 Windows 预设/队列等变化；其中 GUI 发布说明里的 .NET Desktop Runtime 10.0 是 GUI 运行要求，不能直接推定为 CLI 前置条件。

准备工作：下载并解压 CLI

配图待补：需提供该操作对应的 1.11.2 Windows CLI 真实截图，并记录来源、授权、版本与加载检查；当前没有合适的已授权截图。

1. 打开 HandBrake 1.11.2 官方 Release，在 Assets 下载 HandBrakeCLI-1.11.2-win-x86_64.zip。
2. 在资源管理器中将 ZIP 解压到例如 C:\Tools\HandBrakeCLI-1.11.2。确认该目录内有 HandBrakeCLI.exe。
3. 打开 PowerShell，进入解压目录并核对版本：

Set-Location 'C:\Tools\HandBrakeCLI-1.11.2'
.\HandBrakeCLI.exe --version
.\HandBrakeCLI.exe --help

如果解压后的 exe 位于子目录，请将后续命令中的路径改为该实际位置。不要从来源不明的网站下载 CLI。

HandBrakeCLI 转码与扫描步骤

配图待补：需有对应 1.11.2 Windows CLI 转码命令与输出的真实授权截图；当前未提供。

1. 先选一段可丢弃/可重复处理的短素材，保留原文件。确定输入和输出路径，输出文件名不要覆盖源文件。
2. 下面命令展示已验证的参数组合。将输入路径替换为自己的素材路径，输出路径替换为新文件路径；示例 RF 22 不是所有素材或编码器的推荐值：

.\HandBrakeCLI.exe --preset 'Fast 1080p30' --encoder x264 --quality 22 --format av_mp4 -i 'C:\Videos\sample.mp4' -o 'C:\Videos\sample-test.mp4'

1. 等待命令结束并检查退出码：$LASTEXITCODE 为 0 表示该命令成功结束。可将终端输出重定向保存为日志以便复查。
2. 扫描生成文件，确认容器、时长、分辨率及音视频/字幕流：

.\HandBrakeCLI.exe --scan -i 'C:\Videos\sample-test.mp4'

1. 再用实际播放器检查画面、声音、字幕以及目标设备兼容性。扫描识别成功不等于播放器播放验证成功。
2. 若质量或兼容性不合适，保留源片，调整预设/参数并使用新的输出文件名重新编码。不同编码器的 RF 数值不能直接比较。

HandBrakeCLI 结果检查、常见问题与恢复

配图待补：需有对应版本的 CLI 扫描或真实错误恢复截图；当前未提供。

成功时命令返回退出码 0 并生成可扫描输出。体积、质量和耗时取决于源素材、预设与参数，不承诺固定缩小比例。若输出不完整或不合适，确认任务已结束后删除测试输出，再从未修改的源文件重新编码。若提示找不到命令，确认 PowerShell 当前目录含 HandBrakeCLI.exe，并使用 .\HandBrakeCLI.exe 形式调用。

实际验证记录

配图待补：需提供该操作对应的 1.11.2 Windows CLI 真实截图，并记录来源、授权、版本与加载检查；当前没有合适的已授权截图。

2026-10-13 UTC：HandBrakeCLI 1.11.2 对合成 320×240、24fps、3 秒、无音轨/字幕 Y4M 输入运行 Fast 1080p30、x264、RF 22、MP4；编码退出码 0，输入 8,294,875 bytes、输出 8,708 bytes。扫描退出码 0，识别为 3 秒、320×240、24fps、H.264 Main；没有音轨符合合成静音输入，字幕轨为空。预设名中的 1080p 不代表该测试升频，输出仍为 320×240。另一次 Very Fast 480p30 / x264 RF25 编码及扫描也退出码 0，输入 8,294,875 bytes、输出 8,063 bytes。这些合成结果不代表普遍压缩率。GUI Preview、真实素材播放器检查、音轨/字幕保留均未测试。

常见问题（FAQ）

HandBrakeCLI 编码返回 0，就能确认视频正常吗？ 不能；这只说明命令成功结束，还需扫描输出并用播放器检查。

RF 22 适合所有视频吗？ 不是。它仅是已有合成短片记录的设置。官方说明不同编码器的质量刻度不可直接比较，应以短片逐步调整。

为什么输出文件可能比源文件大？ 质量、编码器、预设和输入内容都会影响大小，恒定质量不保证文件一定缩小。保留源片并使用新输出名比较。

可以将命令直接用于 HandBrake GUI 吗？ 不可以；本文只覆盖 Windows CLI 1.11.2，GUI 未测试。

HandBrakeCLI Windows 教程的重点是保留源片、另存新文件，再分别检查扫描结果与播放器表现；现有实测只覆盖合成片段。

官方来源（CLI 实测记录日期：2026-10-13 UTC；文档复核：2026-10-15 Asia/Shanghai）

• 固定版本 Release / Windows CLI 资产（发布于 2026-06-07）：https://github.com/HandBrake/HandBrake/releases/tag/1.11.2
• Quick Start：https://handbrake.fr/docs/en/latest/introduction/quick-start.html
• Adjusting Quality：https://handbrake.fr/docs/en/latest/workflow/adjust-quality.html
• Starting Encoding：https://handbrake.fr/docs/en/latest/workflow/start-encoding.html
• Preview settings（仅作官方 GUI 背景，不表示本文实测）：https://handbrake.fr/docs/en/latest/workflow/preview-settings.html

本文是 HandBrakeCLI 1.11.2 Windows 命令行教程；GUI Preview、真实素材播放及音轨/字幕处理未验证。