VSCode中文乱码本质是文件编码(如GBK)与编辑器默认UTF-8解码不匹配;快速识别真实编码:点击右下角编码名→选Reopen with Encoding→试GBK,若中文立即正常即确认为GBK编码。

VSCode 中文乱码本质是文件编码与编辑器解码不一致,最常见原因是文件保存为 GBK(Windows 默认),但 VSCode 默认用 UTF-8 读取。
如何快速识别当前文件的真实编码
打开乱码文件后,右下角状态栏会显示当前识别的编码(如 UTF-8、GBK、ISO 8859-1)。如果显示错误(比如中文全变成 或方块),点击该编码标签,选择 Reopen with Encoding → 尝试 GBK 或 GB2312。若文字立刻恢复正常,说明文件实际是 GBK 编码。
- 不要依赖文件扩展名或“看起来像不像”,只信右下角编码标识和
Reopen with Encoding的实时效果 - 某些老旧项目(尤其 Windows 下用记事本/旧版 Sublime 保存的)默认就是 GBK,VSCode 不会自动探测 GBK,必须手动选
- 如果
Reopen with Encoding里没有GBK,说明你没装中文语言包或编码支持插件(见下一条)
为什么装了中文语言包后右下角才有 GBK 选项
VSCode 默认精简编码列表,仅保留 UTF-8、UTF-16 等通用编码。中文语言包(Chinese (Simplified) Language Pack)会启用完整编码支持,包括 GBK、GB2312、GB18030。
- 安装方式:打开扩展面板(
Ctrl+Shift+X),搜Chinese,安装官方出品的Chinese (Simplified) Language Pack for Visual Studio Code - 装完无需重启,立刻生效——右下角编码菜单会多出十多个中文相关编码项
- 注意:这不是为了“显示中文界面”,而是为解码中文文本补全底层编码能力
永久避免乱码:统一用 UTF-8 保存 + 关闭自动编码猜测
长期混用 GBK/UTF-8 是维护噩梦。推荐所有新文件强制 UTF-8,并禁用 VSCode 的“自动编码检测”(它经常猜错)。
- 在设置中搜索
files.encoding,设为utf8 - 搜索
files.autoGuessEncoding,**关掉它**(设为false) - 如需兼容老项目,可在项目根目录加
.vscode/settings.json,写入:{"files.encoding": "gbk", "files.autoGuessEncoding": false} - 保存时若弹出“编码不匹配”提示,选
Save with Encoding→UTF-8,而非Save(后者会保留原编码)
Git 提交后中文文件名变乱码(Windows)
这是 Git 自身问题:Windows 默认用 GBK 存文件名,Git 却按 UTF-8 解释,导致 git status 显示一堆问号或畸形字符。
- 运行命令修复:
git config --global core.quotepath false - 再执行:
git config --global core.autocrlf true(兼顾换行符) - 如果已有乱码文件名,先
git add -u,再git commit,Git 会重新索引为正确 UTF-8 文件名 - 该问题与 VSCode 无关,但常被误认为编辑器导致
真正麻烦的不是第一次乱码,而是团队协作时有人开 GBK、有人开 UTF-8,改一行代码就触发编码冲突。最省事的做法:项目初始化时就定死 files.encoding 和 files.autoGuessEncoding,并写进 .vscode/settings.json 提交到仓库。











