KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #codex #typescript #developer-tools #ai-agents #deepseek-harness #claude-code #ai-agent #cli #react #mcp

gbk2utf8-vscode

★ 10 Open GitHub ↗

convert file encode from gbk to utf8 for vscode

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# GBK to UTF8 for VS Code

将 GBK 相关编码(GB2312,GB18030,Big5 等)的文件自动检测并转换为 UTF-8,支持单文件和批量转换.

## 功能特性

- 自动检测 — 打开文件时自动识别编码,检测到 GBK 相关编码即提示转换
- 批量转换 — 选中多个文件或文件夹,右键一键批量转为 UTF-8
- 转换报告 — 批量转换后自动生成 Markdown 格式结果报告
- 文件备份 — 转换前自动备份原始文件,文件名追加 `.bak.`
- 灵活配置 — 支持自定义忽略目录和文件扩展名

## 安装

打开 VS Code,按 `Ctrl + P`,输入以下命令 `ext install buuug7.GBK2UTF8` 安装或者在扩展市场中搜索 **gbk**,**utf8**,**gbk2utf8** 等关键字搜索并安装.

## 使用方法

### 右键菜单

在文件浏览树或编辑器中右键,选择 **Convert Encoding To UTF8** 即可将文件转为 UTF-8.

### 命令面板

按 `Ctrl + Shift + P` 打开命令面板,执行 `GBK2UTF8: Convert Encoding To UTF8` 命令.

### 自动转换

打开 GBK 相关编码的文件时,会自动弹出提示框:

> Seems the encoding of **filename** is GB2312, do you want to convert it to UTF8?

点击 **Yes** 即可将该文件转为 UTF-8.

### 批量转换

在文件资源管理器中选中多个文件或文件夹,右键选择 **Convert Encoding To UTF8** 即可批量转换.

> 注意:同时选中多个文件夹时,仅处理第一个文件夹中的文件.

批量转换完成后,会在工作区根目录自动生成报告文件 `GBK2UTF8-result-2026-06-09T15-30-22.md`

### 文件备份

每次转换前,原始文件会在同级目录自动备份 `原始文件.txt → 原始文件.txt.bak`

## 支持检测的编码

基于 [jschardet](https://github.com/aadsm/jschardet) 检测引擎,支持以下中文编码:

| 编码          | 说明                   |
| ------------- | ---------------------- |
| `GB2312`      | 简体中文(国家标准)     |
| `GB18030`     | 简体中文扩展(含生僻字) |
| `Big5`        | 繁体中文               |
| `EUC-TW`      | 繁体中文(台湾)         |
| `HZ-GB-2312`  | 简体中文(邮件安全编码) |
| `ISO-2022-CN` | 简体中文(ISO 标准)     |

## 配置

在 VS Code 设置中搜索 `GBK2UTF8`,或直接编辑 `settings.json`:

### 自动检测开关

```json
{
  "GBK2UTF8.autoDetect": true
}
```

默认开启,关闭后不再自动检测和提示转换.

### 忽略文件扩展名

```json
{
  "GBK2UTF8.ignoreExtensions": "git,ts,vue"
}
```

逗号分隔,匹配的文件不会被检测和转换.

### 忽略目录

```json
{
  "GBK2UTF8.ignoreDir": "node_modules,.vscode,.idea,.vscode-test,.github"
}
```

逗号分隔,匹配的目录不会被递归遍历.

### 批量转换报告

```json
{
  "GBK2UTF8.showBatchReport": true
}
```

控制批量转换后是否自动生成 Markdown 报告文件.

> 修改设置后建议**重新加载窗口**以确保生效.

## 更新日志

详见 [CHANGELOG.md](./CHANGELOG.md).

## 参与贡献

欢迎提交 Issue 或 Pull Request!

1. Fork [项目仓库](https://github.com/buuug7/gbk2utf8-vscode.git)
2. 创建特性分支:`git checkout -b feature/my-feature`
3. 提交改动:`git commit -am 'Add some feature'`
4. 推送分支:`git push origin feature/my-feature`
5. 提交 Pull Request

## 许可

[MIT](./LICENSE)

gbk2utf8-vscode

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README