BiliBiliCCSubtitle：开源工具实现B站CC字幕高效提取与格式转换

BiliBiliCCSubtitle是一款开源工具，主要功能是从B站（哔哩哔哩）视频中提取CC字幕并支持多种格式转换。该工具通过命令行操作，为用户提供了便捷的字幕获取解决方案，解决了B站默认不提供字幕下载功能的问题，满足了用户对字幕离线保存、格式转换等需求。

核心功能解析

功能特性

BiliBiliCCSubtitle具备多项实用功能，能够满足不同用户在字幕处理方面的需求。它支持从B站视频中精准提取CC字幕，可处理多个分P视频的字幕提取。同时，提供了丰富的格式转换选项，能将提取到的字幕转换为多种主流格式，方便在不同场景下使用。此外，还支持指定输出目录、设置下载模式等功能，增强了工具的灵活性和易用性。

技术优势

该工具在技术上具有显著优势。采用高效的网络请求机制，能够快速、稳定地从B站服务器获取字幕数据。在字幕解析方面，运用专业的JSON解析库，确保对原始字幕数据的准确解析。格式转换模块经过优化，转换效率高且转换后的字幕时间轴精准，保证了字幕与视频的同步性。同时，工具的代码结构清晰，易于维护和扩展。

适用人群

BiliBiliCCSubtitle适用于多种人群。对于外语学习者，可帮助他们获取双语字幕用于对照学习；内容创作者能够通过该工具获取视频字幕作为创作素材；教育工作者可以利用提取的字幕制作教学资料；普通用户在网络不稳定时，可提前下载字幕用于离线观看视频。

场景案例应用

场景一：学术研究 - 视频字幕内容分析

操作目标：提取多个相关视频的字幕，用于学术研究中的内容分析

1. 确定需要提取字幕的视频链接列表，确保这些视频都包含CC字幕。
2. 打开终端，进入工具安装目录。
3. 输入命令：ccdown -b -o ./academic_subs https://bilibili.com/video/BV1aF411p7XQ https://bilibili.com/video/BV1rS4y1Z7fD
   • -b：批量处理模式，用于同时处理多个视频链接
   • -o ./academic_subs：指定输出目录为当前目录下的academic_subs文件夹
   • 后续为多个视频链接，用空格分隔
4. 等待工具执行完成，在指定目录中查看提取到的字幕文件。

重点提示：确保视频链接的有效性和视频包含CC字幕，否则可能无法成功提取。

场景二：视频翻译 - 多语言字幕获取与转换

操作目标：获取视频的多语言字幕并转换为翻译常用格式

1. 准备好需要获取多语言字幕的视频链接。
2. 在终端中输入命令：ccdown -l zh-CN,en-US,ja-JP -c -f tmx -o ./translation_subs https://bilibili.com/video/BV1YL411M71M
   • -l zh-CN,en-US,ja-JP：指定需要获取的字幕语言为中文简体、英语、日语
   • -c：自动转换字幕格式
   • -f tmx：指定转换后的格式为TMX（翻译记忆交换格式）
   • -o ./translation_subs：设置输出目录为translation_subs
3. 执行命令后，工具将下载指定语言的字幕并转换为TMX格式保存到指定目录。

重点提示：部分视频可能不提供所有指定的语言字幕，工具会自动跳过无法获取的语言。

场景三：字幕存档 - 个人收藏视频字幕整理

操作目标：将个人收藏的多个分P视频字幕按统一格式存档

1. 整理个人收藏的视频链接，记录每个视频的分P范围。
2. 打开终端，运行命令：ccdown -s 1 -e 8 -c -o ./collection_subs --archive https://bilibili.com/video/BV1JE411N7UD
   • -s 1 -e 8：指定提取第1到第8分P的字幕
   • -c：自动转换为SRT格式
   • -o ./collection_subs：输出目录为collection_subs
   • --archive：启用存档模式，对字幕文件进行统一命名和整理
3. 工具执行完毕后，在collection_subs目录中会看到按分P编号和语言命名的SRT字幕文件。

重点提示：存档模式下，工具会自动创建规范的文件命名，便于后续查找和管理。

进阶技巧指南

核心模块介绍

BiliBiliCCSubtitle主要由以下核心模块构成：

• 网络请求模块：负责与B站服务器建立连接，发送字幕获取请求并接收返回的数据。
• 字幕解析模块：对获取到的原始JSON格式字幕数据进行解析，提取出字幕文本、时间轴等关键信息。
• 格式转换模块：根据用户需求，将解析后的字幕数据转换为不同的格式，如SRT、ASS、TMX等。
• 文件管理模块：负责创建输出目录、保存字幕文件，并对文件进行命名和整理。

工作流程说明

工具的工作流程如下：

1. 用户在命令行输入相关参数和视频链接。
2. 网络请求模块根据视频链接向B站服务器发送字幕获取请求。
3. 服务器返回JSON格式的字幕数据，由字幕解析模块进行解析。
4. 解析后的字幕数据传递给格式转换模块，按照用户指定的格式进行转换。
5. 文件管理模块创建输出目录，将转换后的字幕文件保存到指定位置。

架构图

数据处理方式

在数据处理方面，工具采用了高效的方式。对于网络请求获取的数据，先进行完整性校验，确保数据无误后再进行解析。解析过程中，对时间轴数据进行精确处理，保证转换后的字幕时间准确性。格式转换时，根据不同格式的规范对字幕数据进行格式化处理，生成符合标准的字幕文件。

常见问题解决

问题现象：提取字幕时提示"无法连接到服务器"

原因分析：可能是网络连接问题、B站服务器暂时不可用或视频链接错误。 解决步骤：

1. 检查网络连接是否正常，尝试打开其他网页确认网络状况。
2. 验证视频链接是否正确，确保链接完整且能在浏览器中正常打开。
3. 稍后重试，可能是B站服务器临时故障，等待一段时间后再进行尝试。

问题现象：转换后的字幕出现乱码

原因分析：可能是字幕文件的编码格式与目标格式不兼容，或原始字幕数据存在特殊字符。 解决步骤：

1. 检查原始字幕文件的编码格式，确保与转换工具支持的编码一致。
2. 尝试使用工具的编码转换参数，指定输出字幕的编码格式，如-encoding utf-8。
3. 如果问题仍然存在，可能是原始字幕数据中包含特殊字符，可尝试使用文本编辑器手动修改乱码部分。

问题现象：批量提取字幕时部分视频提取失败

原因分析：可能是部分视频没有CC字幕，或视频链接无效，也可能是网络不稳定导致部分请求失败。 解决步骤：

1. 逐一检查失败的视频链接，确认链接是否有效以及视频是否包含CC字幕。
2. 对于确认有CC字幕但提取失败的视频，可单独重新提取。
3. 如果是网络问题，可尝试在网络状况较好时重新执行批量提取命令。

使用指南

安装准备

在安装BiliBiliCCSubtitle之前，需确保系统已安装以下依赖：

• CMake（3.10+）：用于项目的编译构建。
• libcurl：用于处理网络请求。
• jsoncpp：用于解析JSON格式数据。

获取源码

git clone https://gitcode.com/gh_mirrors/bi/BiliBiliCCSubtitle

编译安装

Windows系统

1. 打开命令提示符，进入源码目录：cd BiliBiliCCSubtitle
2. 创建构建目录并进入：mkdir build && cd build
3. 运行CMake生成项目文件：cmake ..
4. 使用MSBuild编译项目：msbuild BiliBiliCCSubtitle.sln /p:Configuration=Release
5. 安装：msbuild INSTALL.vcxproj /p:Configuration=Release

macOS系统

1. 打开终端，进入源码目录：cd BiliBiliCCSubtitle
2. 创建构建目录并进入：mkdir build && cd build
3. 运行CMake：cmake ..
4. 编译：make
5. 安装：sudo make install

Linux系统

1. 打开终端，进入源码目录：cd BiliBiliCCSubtitle
2. 创建构建目录并进入：mkdir build && cd build
3. 运行CMake：cmake ..
4. 编译：make
5. 安装：sudo make install

验证安装

安装完成后，在终端输入以下命令验证是否安装成功：

ccdown --version

如果显示工具的版本号，则说明安装成功。