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!
- Fork 项目仓库
- 创建特性分支:
git checkout -b feature/my-feature
- 提交改动:
git commit -am 'Add some feature'
- 推送分支:
git push origin feature/my-feature
- 提交 Pull Request
许可
MIT
