# EncodingConverter

**Repository Path**: xa87/encoding-converter

## Basic Information

- **Project Name**: EncodingConverter
- **Description**: 一个简单易用的文件编码转换工具，支持多种编码格式的自动识别和转换。由AI生成。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-24
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Encoding Converter (enc-conv)

一个简单易用的文件编码转换工具，支持多种编码格式的自动识别和转换。

## 功能特性

- 支持多种编码格式：UTF-8、UTF-8 (BOM)、GB2312/GBK
- 自动识别源文件编码
- 批量处理文件或目录
- 支持文件备份功能
- 带进度条的可视化操作界面
- 命令行界面友好

## 安装与运行

### 系统要求

- .NET 10.0 运行时
- Windows, Linux 或 macOS 系统

### 安装方法

```bash
# 克隆项目
git clone <repository-url>
cd EncodingConverter

# 构建项目
dotnet build

# 运行程序
dotnet run
```

### 直接运行（无需编译）

```bash
dotnet run
```

## 使用方法

1. 运行程序：`dotnet run` 或直接执行生成的可执行文件
2. 输入要转换的文件或目录路径
3. 选择文件过滤模式（适用于目录）
4. 选择目标编码格式
5. 选择是否创建备份（推荐）
6. 等待转换完成

## 支持的编码格式

| 编码名称 | 代码页 | 说明 |
|---------|--------|------|
| UTF-8 | utf-8 | 标准 UTF-8 编码 |
| UTF-8 (含BOM) | utf-8-bom | 带 BOM 头的 UTF-8 编码 |
| GB2312 / GBK | gbk | 中文简体编码 |

## 功能说明

### 自动编码检测
程序会自动检测源文件的编码格式，支持 UTF-8、GB2312/GBK 等编码。

### 备份功能
在转换前会自动创建备份，备份文件会以 ZIP 格式保存到原目录。

### 批量处理
支持单个文件或整个目录的批量处理，通过文件过滤模式控制处理的文件类型。

## 界面截图

（这里可以添加界面截图）

## 常见问题

### Q: 为什么转换后文件变大了？
A: 这可能是因为从低编码（如 GB2312）转换为高编码（如 UTF-8），字符编码后占用字节数增加。

### Q: 如何恢复备份？
A: 备份文件为 ZIP 格式，直接解压即可恢复。

## 开发说明

### 项目结构
- `Program.cs` - 主程序入口
- `EncodingConverter.csproj` - 项目配置文件
- `TrimmerRoots.xml` - AOT 修剪配置文件

### 技术栈
- .NET 10.0
- System.Text.Encoding.CodePages (支持更多编码)
- Spectre.Console (命令行界面美化)
- AOT 编译优化

## 许可证

MIT License

## 贡献

欢迎提交 Issues 和 Pull Requests 来改进这个工具。

## 版本历史

### v1.0
- 初始版本
- 支持基础的编码转换功能
- 支持备份和批量处理