go-astisub CLI命令详解：轻松实现字幕转换、同步与合并

go-astisub CLI命令详解：轻松实现字幕转换、同步与合并

【免费下载链接】go-astisubManipulate subtitles in GO (.srt, .ssa/.ass, .stl, .ttml, .vtt (webvtt), teletext, etc.)项目地址: https://gitcode.com/gh_mirrors/go/go-astisub

go-astisub是一款功能强大的Go语言字幕处理工具，支持.srt、.ssa/.ass、.stl、.ttml、.vtt等多种格式的字幕文件操作。通过其命令行接口（CLI），用户可以轻松完成字幕转换、同步、合并等常见任务，无需编写复杂代码。本文将详细介绍go-astisub CLI的核心功能和使用方法，帮助新手快速掌握字幕处理技巧。

安装与基础配置

快速安装步骤

首先需要通过Git克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/go/go-astisub cd go-astisub go build -o astisub ./cmd/astisub

编译完成后，可执行文件astisub将生成在当前目录，直接运行即可使用所有字幕处理功能。

命令结构概览

go-astisub CLI采用"主命令+子命令"的结构设计，基础语法格式为：

./astisub [子命令] -i [输入文件] -o [输出文件] [可选参数]

其中输入文件（-i）和输出文件（-o）是所有操作的必填项，文件格式将通过扩展名自动识别。

核心功能详解

1. 字幕格式转换（convert）

功能：将一种格式的字幕文件转换为另一种格式，支持所有主流字幕格式互转。

使用示例：将SRT格式转换为WebVTT格式

./astisub convert -i example-in.srt -o output.vtt

支持的输入格式：.srt、.ssa/.ass、.stl、.ttml、.vtt、teletext
输出格式由-o参数的文件扩展名自动决定

2. 字幕同步（sync）

功能：通过时间偏移量调整所有字幕条目的显示时间，解决音画不同步问题。

使用示例：将字幕整体延后2秒（正值延后，负值提前）

./astisub sync -i example-in.srt -o synced.srt -s 2s

参数说明：

• -s：时间偏移量，支持s（秒）、ms（毫秒）等单位，如1500ms表示1.5秒

3. 线性时间校正（apply-linear-correction）

功能：通过两个时间点的实际值与期望值，对字幕进行线性时间校正，适用于处理整体时间轴偏移且增速/减速的情况。

使用示例：

./astisub apply-linear-correction \ -i example-in.srt -o corrected.srt \ -a1 10m -d1 9m50s \ # 第一个实际时间点10分钟对应期望9分50秒 -a2 20m -d2 19m30s # 第二个实际时间点20分钟对应期望19分30秒

4. 字幕合并（merge）

功能：将两个字幕文件合并为一个，自动按时间轴排序，适用于添加双语字幕或合并不同来源的字幕。

使用示例：

./astisub merge \ -i chinese.srt english.srt \ # 输入两个字幕文件 -o bilingual.srt # 输出合并后的文件

5. 字幕分段与合并（fragment/unfragment）

功能：

• fragment：将长字幕按指定时长分割为多个短条目
• unfragment：将分段的字幕重新合并为完整条目

使用示例：

# 将字幕按3秒分段 ./astisub fragment -i long.srt -o fragmented.srt -f 3s # 合并分段字幕 ./astisub unfragment -i fragmented.srt -o unfragmented.srt

6. 字幕优化（optimize）

功能：自动优化字幕结构，包括移除重复条目、修复时间重叠、规范格式等。

使用示例：

./astisub optimize -i messy.srt -o optimized.srt

高级应用场景

批量处理工作流

结合Shell脚本可实现批量字幕处理，例如批量转换目录下所有SRT文件为WebVTT：

for file in *.srt; do ./astisub convert -i "$file" -o "${file%.srt}.vtt" done

teletext字幕提取

go-astisub支持从teletext中提取字幕，需指定页码参数：

./astisub convert -i video.ts -o teletext.srt -p 888

常见问题解决

格式转换后出现乱码

确保输入文件编码为UTF-8，对于非UTF-8编码文件，可先用文本编辑器转换编码后再处理。

时间校正不准确

使用apply-linear-correction时，建议选择视频中两个清晰可辨的时间点（如片头和片尾），以获得最佳校正效果。

合并后字幕顺序混乱

合并前确保两个字幕文件的时间轴基准一致，如均以视频开始时间为基准。

总结

go-astisub CLI提供了一套完整的字幕处理解决方案，通过简单的命令行操作即可完成格式转换、时间同步、字幕合并等复杂任务。无论是视频创作者、翻译人员还是普通用户，都能通过这款工具轻松处理各种字幕需求。其源码主要实现于cmd/astisub/main.go，核心字幕处理逻辑位于subtitles.go等文件中，感兴趣的开发者可以深入研究实现细节。

【免费下载链接】go-astisubManipulate subtitles in GO (.srt, .ssa/.ass, .stl, .ttml, .vtt (webvtt), teletext, etc.)项目地址: https://gitcode.com/gh_mirrors/go/go-astisub