VSCode中文注释乱码主因是文件实际编码(如GBK)与编辑器默认UTF-8解码不匹配,导致“锟斤拷”或方块;应先右下角点编码→Reopen with Encoding验证真实编码,确认后Save with Encoding→UTF-8保存,并禁用autoGuessEncoding以稳定行为。

VSCode中文注释乱码不是字体或语言包问题,而是文件实际编码和编辑器解码方式不匹配——最常见的是用UTF-8去读GBK保存的文件,直接显示“锟斤拷”或方块。
右下角点编码名 → 选 Reopen with Encoding 验证真实编码
这是最快、最安全的第一步,不改文件、不改设置,只验证当前文件到底是什么编码。
- 点击右下角状态栏显示的编码(如
UTF-8或GBK),弹出菜单后选Reopen with Encoding - 依次尝试:
GBK(Windows记事本默认)、GB2312(部分老系统)、UTF-8 with BOM(Excel/Notepad++导出常见)、UTF-8(新项目标准) - 只要中文立刻变正常,就说明找对了;如果全试完仍乱码,可能是混合编码或含不可见控制字符,建议复制内容到新文件再操作
确认显示正常后必须 Save with Encoding → UTF-8
只靠 Reopen with Encoding 是临时解码,下次打开还会乱——必须把文件内容真正转成通用编码。
- 中文显示正常后,再次点击右下角编码名,这次选
Save with Encoding→UTF-8(注意:不是UTF-8 with BOM,后者在 Python/Shell 脚本里可能引发SyntaxError: Non-UTF-8 code starting with '\xff') - 保存后 Git diff 会显示完整变更,协作时其他人也不用再手动切编码
- 如果文件里有特殊符号或注释混用,保存前建议先粘贴到新文件再操作,避免转码污染原始结构
关掉 files.autoGuessEncoding 才能稳定
这个开关开着反而更糟:短文本、纯数字+中文、无BOM的GBK文件,VSCode常误判成 ISO-8859-1 或 windows1252,刚打开就变乱码。
- 在
settings.json中加这一行:"files.autoGuessEncoding": false - 配合设
"files.encoding": "utf8",让 VSCode 完全按你指定的规则读写,行为可预期 - 老项目混GBK?别全局硬设
utf8,应在工作区.vscode/settings.json单独配,或用"[java]": { "files.encoding":"GBK" }按语言精准覆盖
新建文件粘贴中文后保存变乱码?那是写入阶段就错了
新建文件虽标 UTF-8,但若系统区域设为中文(中国),部分底层调用仍走GBK路径写入——粘贴完一保存,字节就错了。
- 新建文件后,先手动点右下角编码 →
Save with Encoding→UTF-8,再粘贴、再保存 - 永久解决:在
settings.json加两行:"files.autoGuessEncoding": false和"files.encoding": "utf8" - 注意:
.bat或.reg文件依赖GBK,全局设死utf8可能导致执行报错,得靠files.associations单独配
真正难处理的不是单个文件,而是那些没BOM、又混着英文注释和中文注释的老源码——它们在十六进制里看不出头绪,靠猜编码只会反复失败。这时候不如直接用 iconv 或 Notepad++ 批量转码,比在VSCode里兜圈子更省时间。


















