解决VSCode中常见的中文乱码问题_网络技术_宿州市腾雀网络科技有限公司

发布时间 - 2025-12-25 00:00:00 点击率：次

VSCode中中文文件乱码是因编码识别错误或默认设置不匹配所致，可通过手动更改编码、设默认编码为UTF-8、配置文件关联编码规则及禁用自动编码检测四种方法解决。

如果您在VSCode中打开中文文件时出现方块、问号或符号错乱等现象，则可能是由于文件编码识别错误或编辑器默认编码设置不匹配所致。以下是解决此问题的多种方法：

本文运行环境：MacBook Air，macOS Sequoia。

一、手动更改编码格式

VSCode支持在右下角状态栏快速切换当前文件的编码格式，该操作仅影响当前文件，不会更改全局设置，适合临时修复单个乱码文件。

1、在VSCode中打开出现乱码的中文文件。

2、点击窗口右下角显示编码的位置（如“UTF-8”“GBK”或“自动检测”字样）。

3、在弹出菜单中选择通过编码重新打开，然后尝试依次选择“GBK”“GB2312”“UTF-8 with BOM”等常见中文编码。

4、若某一种编码使文字正常显示，说明原始文件即为此编码格式。

将VSCode的默认文件编码设为UTF-8可避免多数新建或未声明编码的中文文件出现乱码，尤其适用于跨平台协作场景。

1、按下Cmd + ,（macOS）打开设置界面。

2、在搜索框中输入files.encoding。

3、找到“Files: Encoding”选项，在下拉菜单中选择utf8。

4、关闭设置页，重启VSCode使配置生效。

针对特定后缀名的文件（如.md、.txt、.log），可通过settings.json强制指定编码，避免每次手动切换。

1、按下Cmd + Shift + P打开命令面板。

2、输入并选择Preferences: Open Settings (JSON)。

3、在大括号内添加如下代码段：

"files.associations": { "*.md": "utf8", "*.txt": "gbk", "*.log": "gb2312" }。

4、保存文件，重新打开对应类型文件验证效果。

VSCode的自动编码检测功能有时会误判中文文件为其他编码（如windows1252），导致强制以错误方式解码，关闭该功能可提升稳定性。

1、打开命令面板（Cmd + Shift + P）。

2、输入并选择Preferences: Open Settings (JSON)。

3、在settings.json中添加键值对："files.autoGuessEncoding": false。

4、保存后，VSCode将不再尝试猜测编码，仅依据文件BOM或用户设定的encoding加载。