保存后中文异常是因VSCode用错编码写入文件;应先右下角点“UTF-8”→“Reopen with Encoding”选GBK确认正常显示,再“Save with Encoding”→UTF-8转码,切勿直接另存为UTF-8导致二次损坏。

保存后中文显示异常,基本是 VSCode 用错了编码写入文件——不是“看不清”,而是“存错了”。你看到的乱码(比如 涓枃、閫夋嫨)大概率是 GBK 字节被当 UTF-8 存了一遍,或反过来。
为什么“另存为 UTF-8”反而让问题更糟
很多人一见乱码就右下角点“另存为”,选 UTF-8 然后覆盖保存。这动作在多数情况下等于二次破坏:
- 原文件是 GBK 编码(如老 INI、注册表导出、某些 C++ 项目配置),VSCode 用 UTF-8 解码后显示为乱码,此时内容在内存里已是错的字节序列;
- 再“另存为 UTF-8”,就是把这一堆错的字节原样当 UTF-8 写进磁盘——结果文件彻底不可逆损坏;
- 正确做法是:先用对的编码“重新打开”,确认内容正常,再另存为 UTF-8(如果真需要)。
保存前必须确认的三件事
每次保存含中文的文件前,快速核对以下三点,能避开 90% 的保存异常:
- 右下角状态栏显示的编码是否和文件真实编码一致?常见组合:
GBK(Windows 老程序)、UTF-8 with BOM(部分 .bat/.ps1)、UTF-8(现代标准); - 如果状态栏显示
UTF-8但中文是乱的,别保存,先点它 → 选“通过编码重新打开” → 试GBK或GB2312; - 改完内容后想统一转 UTF-8?先确保当前显示完全正常,再点右下角编码 → “另存为编码” → 选
UTF-8,**不要勾选 “UTF-8 with BOM”**(除非目标环境明确要求)。
settings.json 里写错 encoding 会静默失效
如果你在 settings.json 里配了 "files.encoding": "gbk" 却没生效,大概率是 JSON 格式错了:
- VSCode 不报错,只跳过整个
settings.json文件,相当于没配; - 常见错误:
// 注释、末尾多逗号、单引号代替双引号、值写成字符串(如"files.autoGuessEncoding": "true"应为true); - 安全做法:Ctrl+Shift+P →
Preferences: Open Settings (JSON)→ 清空内容只留{}→ 保存 → 完全退出 VSCode(macOS 查 Activity Monitor 确认无Code Helper进程)→ 重启。
终端输出中文保存到文件也乱码?那是 cmd/powershell 的锅
在 VSCode 集成终端运行 Python/Node.js 输出中文,重定向到文件后乱码(如 python main.py > out.txt),问题不在 VSCode,而在 Windows 终端默认编码:
- cmd 默认是
GBK(chcp 936),但重定向时可能按系统 locale 解析,导致 UTF-8 程序输出被当 GBK 存; - 临时解决:运行前先执行
chcp 65001(切换到 UTF-8); - 一劳永逸:在 VSCode 设置中加这条,让集成终端启动时自动切编码:
"terminal.integrated.env.windows": { "CHCP": "65001" }注意:这不是环境变量,是让终端执行chcp 65001命令。
最常被忽略的一点:乱码不是“显示问题”,而是“编码链断裂”。从文件保存、终端输入、程序输出、重定向写入,每个环节都可能用错编码。盯住右下角那个小编码标识,它比任何设置都诚实。











