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 检测引擎,支持以下中文编码:

配置

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

自动检测开关

{
  "GBK2UTF8.autoDetect": true
}

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

忽略文件扩展名

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

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

忽略目录

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

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

批量转换报告

{
  "GBK2UTF8.showBatchReport": true
}

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

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

更新日志

详见 CHANGELOG.md.

参与贡献

欢迎提交 Issue 或 Pull Request!

1. Fork 项目仓库
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