GBK 转 UTF-8 项目技术文档
项目地址: https://gitcode.com/gh_mirrors/gb/GBKtoUTF-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 开发环境安装
如果用户希望在开发环境中运行该项目，需要满足以下先决条件：
通过以上步骤，用户可以顺利安装并使用 GBK 转 UTF-8 工具。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
