必须同时设置"files.encoding": "utf8"、"files.autoGuessEncoding": false和"files.saveWithBOM": false,否则因默认启用自动猜测,VSCode会无视UTF-8设置而将无BOM中文文件误判为GBK或ISO-8859-1导致乱码。

VSCode 全局设 UTF-8 编码,光改 files.encoding 不够,必须同步关掉自动猜测——否则新建文件或打开老文件时仍会变成 GBK 或 ISO-8859-1,右下角一显示这些就说明没生效。
为什么改了 files.encoding 还是乱码?
因为 VSCode 默认开启 files.autoGuessEncoding,它会扫描文件字节特征“猜”编码。一个没 BOM 的中文文本,在 Windows 上几乎必被猜成 GBK,完全无视你设的 "files.encoding": "utf8"。
-
files.autoGuessEncoding: true(默认)= 优先信猜测,files.encoding形同虚设 - 右下角状态栏显示
GBK或ISO-8859-1就是典型表现 - 这个猜测结果会被缓存,下次打开同一文件直接复用,不会重新读配置
真正起作用的三行配置
打开命令面板(Ctrl+Shift+P),执行 Preferences: Open Settings (JSON),在用户 settings.json 中添加:
{
"files.encoding": "utf8",
"files.autoGuessEncoding": false,
"files.saveWithBOM": false
}
-
"utf8"是 VSCode 内部标识,等价于 UTF-8 无 BOM;写"UTF-8"或"utf8bom"都无效 -
files.autoGuessEncoding: false是关键开关,关掉它,VSCode 才会老老实实按files.encoding读新文件、存所有文件 -
files.saveWithBOM: false防止 Python/Shell 脚本报SyntaxError: Non-UTF-8 code starting with '\xff'
已有乱码文件怎么救?
全局设置只影响新建文件和保存动作,对已打开过的文件完全无效——VSCode 会记住每个文件上次用什么编码打开,并优先沿用。
- 点击右下角当前编码(比如显示
GBK),选Reopen with Encoding → UTF-8验证是否变正常 - 如果内容正确,立刻按
Ctrl+S保存 —— 这步触发Save with Encoding → UTF-8,真实写回磁盘并把该选择记为该文件的“偏好” - 菜单灰掉?先
Ctrl+S保存一次再点 - 别选
UTF-8 with BOM,Python 和 Git 都不认它
最易忽略的是:项目根目录下的 .vscode/settings.json 会覆盖用户设置。打开项目前先检查它是否存在、是否含冲突配置(比如 "files.encoding": "utf8bom"),否则全局三行写了也白写。


















