【亲测免费】 GBK 转 UTF-8 项目技术文档

1. 安装指南

1.1 下载可执行文件

项目提供了两种可执行文件供用户选择：

• GBK.to.UTF-8_with-runtime.exe：已内置框架（.NET 桌面运行时），无需另外安装，可直接运行。
• GBK.to.UTF-8.exe：未内置框架，需自行安装.NET 6 桌面运行时，方可运行。

1.2 系统要求

根据不同的操作系统版本，用户可能需要安装额外的运行库：

• Windows 11：所有版本均支持。
• Windows 10：需要 1607 或更高版本。
• Windows 8.1：需要安装 VC++ 2015~2019 运行库。
• Windows 7：需要安装 VC++ 2015~2019 运行库。

1.3 安装.NET 6 桌面运行时

如果选择使用 GBK.to.UTF-8.exe，用户需要自行安装 .NET 6 桌面运行时。

2. 项目的使用说明

2.1 选择文件或文件夹

用户可以选择多个文件，或者选择一个文件夹（支持在子文件夹中查找），但二者不可同时选择。

2.2 转码操作

选择文件或文件夹后，工具将自动将文件从 GBK 编码转换为 UTF-8 编码。

3. 项目API使用文档

3.1 核心API

项目的主要功能是通过命令行或图形界面调用核心API来实现文件编码的转换。核心API包括以下几个主要方法：

• ConvertFile(string filePath)：将指定路径的文件从 GBK 转换为 UTF-8。
• ConvertFolder(string folderPath)：将指定文件夹及其子文件夹中的所有文件从 GBK 转换为 UTF-8。

3.2 错误处理

在转换过程中，如果遇到无法读取或写入的文件，API 会抛出相应的异常，用户可以通过捕获这些异常来处理错误。

4. 项目安装方式

4.1 直接运行

对于 GBK.to.UTF-8_with-runtime.exe，用户只需下载并双击运行即可。

4.2 安装.NET 6 桌面运行时

对于 GBK.to.UTF-8.exe，用户需要先安装 .NET 6 桌面运行时，然后下载并双击运行。

4.3 开发环境安装

如果用户希望在开发环境中运行该项目，需要满足以下先决条件：

• 安装 .NET 6 SDK。
• 安装 Visual Studio 2022 或 Visual Studio Code。

通过以上步骤，用户可以顺利安装并使用 GBK 转 UTF-8 工具。