VSCode处理中文乱码需按需切换编码而非永久改全局设置:右下角点击编码可Reopen with Encoding修正显示或Save with Encoding转存为UTF-8;启用files.autoGuessEncoding可辅助识别GBK等编码;批量转换可用手动操作或iconv;新项目应统一设UTF-8并配置.vscode/settings.json。

VSCode 默认用 UTF-8 打开文件,但遇到 GBK、GBK2312、Big5 等中文编码的文件时,常显示乱码。关键不是“永久改全局编码”,而是按需识别、手动切换、自动保存为合适格式。
查看和临时切换当前文件编码
右下角状态栏会显示当前文件编码(如 UTF-8 或 GBK)。点击它,会弹出编码选择菜单:
- 选 Reopen with Encoding → 再选 GBK:用 GBK 重新解码当前文件(不改变文件内容,只修正显示)
- 选 Save with Encoding → 再选 UTF-8:把当前已正确显示的内容,以 UTF-8 编码存盘(推荐长期使用)
让 VSCode 自动识别常见中文编码(需启用)
VSCode 本身不默认自动探测 GBK,但可通过设置开启简易识别:
- 打开设置(Ctrl+,),搜索 files.autoGuessEncoding
- 勾选它(设为 true)
- 重启 VSCode 后,对新建或未编辑过的 GBK 文件,有一定概率自动识别并正确显示
注意:自动识别非 100% 可靠,尤其当文件无中文或内容较短时容易误判,所以仍建议人工确认右下角编码。
批量处理旧项目中的 GBK 文件(转为 UTF-8)
老项目一堆 .txt/.js/.html 是 GBK?别一个个点——用「保存为」+「替换文件」更稳妥:
- 用 VSCode 打开一个 GBK 文件 → 右下角点编码 → Reopen with Encoding → GBK(确保显示正常)
- 再点右下角 → Save with Encoding → UTF-8
- 重复以上两步处理其他文件;也可配合插件如 Encode Switcher 或终端命令
iconv -f GBK -t UTF-8 file.js > file_utf8.js
避免未来乱码:统一团队编码约定
最省事的方式是预防:
- 新项目一律用 UTF-8 with BOM(可选) 或无 BOM UTF-8(推荐)
- 在项目根目录加 .vscode/settings.json,写入:
"files.encoding": "utf8" - 搭配 ESLint / Prettier 等工具,拒绝 GBK 提交(Git pre-commit 钩子可校验)
基本上就这些。不用改系统区域设置,也不用装一堆编码插件——看清右下角、手动切一次、保存为 UTF-8,多数乱码问题当场解决。










