# Chgcp_Tools

**Repository Path**: yylmzxc/chgcp_-tools

## Basic Information

- **Project Name**: Chgcp_Tools
- **Description**: Chgcp_Tools
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-06
- **Last Updated**: 2025-10-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 控制台编码切换器

一个简单实用的Windows控制台编码切换工具，可以在UTF-8和GBK编码之间自由切换，解决控制台中文显示乱码问题。

## 功能特性

- **一键切换编码**：快速在UTF-8和GBK编码之间切换
- **自动检测环境**：智能识别是Windows Terminal还是传统cmd.exe环境
- **永久生效选项**：可选择是否永久保存编码设置
- **执行文件支持**：内置批处理文件(.bat)和可执行文件(.exe)运行功能
- **详细日志记录**：记录所有操作过程和结果
- **系统默认编码恢复**：随时可恢复系统默认编码配置

## 系统要求

- Windows 10/11 操作系统
- .NET 9.0 运行时环境
- 管理员权限（修改注册表设置需要）

## 安装方法

1. 下载最新版本的发布文件
2. 解压缩到任意目录
3. 双击 `Chgcp_Tools.exe` 运行程序
4. 如需创建桌面快捷方式，右键程序文件选择"发送到" > "桌面快捷方式"

## 使用说明

### 基本操作

1. 运行程序后，主界面会显示当前控制台编码信息
2. 点击**UTF-8**按钮，将控制台编码切换为UTF-8（代码页65001）
3. 点击**GBK**按钮，将控制台编码切换为GBK（代码页936）
4. 点击**恢复默认**按钮，将控制台编码恢复为系统默认值
5. 勾选**永久生效**复选框，可将编码设置保存为默认设置

### 运行批处理文件

1. 点击**选择BAT文件**按钮，浏览并选择要执行的批处理文件
2. 在下拉菜单中选择运行模式（UTF-8或GBK）
3. 点击**运行BAT**按钮，以指定编码运行批处理文件

### 运行可执行文件

1. 点击**选择EXE文件**按钮，浏览并选择要执行的可执行文件
2. 如需传递参数，在参数输入框中输入命令行参数
3. 点击**运行EXE**按钮，以当前编码运行可执行文件

## 工作原理

### Windows Terminal环境

- 程序会自动检测Windows Terminal配置文件
- 在配置文件中添加`"experimental.useUnicodeUTF8": true`配置项
- 启用Windows Terminal对UTF-8编码的完整支持

### 传统cmd.exe环境

- 通过修改注册表`HKCU\Console\CodePage`值来设置默认编码
- 清理子节点的旧编码配置，避免冲突设置
- 设置编码页为UTF-8（65001）或GBK（936）

## 注意事项

1. 修改Windows Terminal配置后需要重启Terminal才能生效
2. 某些旧版应用程序可能不支持UTF-8编码，建议使用GBK模式
3. 永久生效设置可能会影响其他依赖特定编码的程序
4. 如果遇到权限问题，请以管理员身份运行程序

## 常见问题

### Q: 为什么修改后没有立即生效？
A: Windows Terminal需要重启才能应用新的配置，cmd.exe需要关闭现有窗口重新打开。

### Q: 如何恢复到原始系统设置？
A: 点击程序中的"恢复默认"按钮即可恢复系统原始编码设置。

### Q: 程序支持Windows 7系统吗？
A: 由于使用了.NET 9.0和较新的Windows API，程序可能无法在Windows 7上正常运行。

## 更新日志

### v1.0.0
- 初始版本发布
- 实现基本的编码切换功能
- 支持Windows Terminal和cmd.exe环境
- 提供批处理和可执行文件运行功能

## 许可证

MIT License

## 关于作者

这是一个用于解决控制台编码问题的开源小工具，希望对您有所帮助！如有任何问题或建议，请在项目仓库中提交Issue。