GBK to UTF8 for VS Code

将任意非 UTF-8 编码的文件转换为 UTF-8, 支持单文件和批量转换. 并且打开文件时自动识别编码, 检测到非 UTF-8 编码即会提示是否转换(可通过配置关闭自动检测).

功能特性

• 批量转换 — 选中多个文件或文件夹,右键一键批量转为 UTF-8
• 自动检测 — 打开文件时自动识别编码,检测到非 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 with 99% confidence, do you want to convert it to utf-8?

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

批量转换

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

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

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

文件备份

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

配置

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

自动检测开关

{
  "GBK2UTF8.autoDetect": true
}

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

忽略文件扩展名

{
  "GBK2UTF8.ignoreExtensions": "git,bak,zip,rar,7z,gz,tar,jpg,jpeg,png,gif,bmp,ico,webp,mp3,mp4,avi,mkv,wav,flac,exe,dll,so,pdf,doc,docx,xls,xlsx,ppt,pptx,ttf,otf,sqlite"
}

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

忽略目录

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

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

批量转换报告

{
  "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