VSCode 打开 INI 文件中文乱码？别急着保存，先看这篇

程序员江涛_RiverPlus
0 阅读5分钟

VSCode 打开 INI 文件中文乱码？别急着保存，先看这篇

写在前面

如果你从 Windows 程序、旧项目或者别人电脑上拿到一个 .ini 文件，用 VSCode 打开后发现：

  • 英文正常，中文变成 ����
  • 或者出现 ÖÐÎÄ、锟斤拷 这类奇怪字符
  • 配置文件里的注释、路径、用户名全乱了

先别慌，也千万别直接按 Ctrl+S 保存。

这通常不是文件坏了，而是 VSCode 用错了编码去读它。

一、为什么 INI 文件会乱码？

核心原因一句话：

INI 文件本身没有强制规定编码，而 VSCode 默认常按 UTF-8 解码。

但很多 Windows 下的 INI 文件，尤其是老程序生成的，可能是：

  • GBK
  • GB2312
  • GB18030
  • UTF-16 LE
  • UTF-16 BE
  • UTF-8 with BOM
  • Windows ANSI 代码页

其中最常见的是：

文件来源常见编码
旧版 Windows 记事本保存的“ANSI”简体中文系统下通常是 GBK/GB18030
旧版记事本保存的“Unicode”UTF-16 LE
新版记事本默认保存UTF-8
VSCode 默认打开UTF-8
某些老软件生成的 INIGBK/ANSI

所以当 VSCode 用 UTF-8 去读一个 GBK 文件时，中文就会乱码。

二、最重要原则：先“重新打开”，再“保存”

很多人一看到乱码，就手动改几个字，然后保存。
这样非常危险。

因为 VSCode 会把你看到的乱码字符，再按当前编码写回文件。
原来的字节可能就永久丢失了，文件可能再也恢复不回来。

正确顺序是：

  1. 先备份文件。
  2. 用“通过编码重新打开”让中文正常显示。
  3. 确认没问题后，再决定是否“通过编码保存”。

三、手动修复步骤

方法一：点右下角编码

  1. 用 VSCode 打开乱码的 INI 文件。
  2. 看右下角状态栏，通常会显示 UTF-8。
  3. 点击这个 UTF-8。
  4. 选择 Reopen with Encoding / 通过编码重新打开。
  5. 依次尝试：
    • GB18030
    • GBK
    • UTF-16 LE
    • UTF-16 BE
    • UTF-8 with BOM
  6. 哪个能正常显示中文，就说明原文件大概率是那个编码。

方法二：用命令面板

按 Ctrl + Shift + P，输入：

Reopen with Encoding

然后选择编码重新打开。

如果中文正常了，说明选对了。

如果你想把文件转成 UTF-8，再按：

Save with Encoding

选择：

UTF-8

但注意：不是所有 INI 都适合转 UTF-8，后面会讲。

四、一劳永逸：开启自动猜测编码（推荐）

你提到的这个设置确实很好用：

"files.autoGuessEncoding": true

开启后，VSCode 在打开文件时会尝试自动猜测编码，减少手动切换。

在设置界面开启

  1. 打开 VSCode 设置。
  2. 搜索：
Auto Guess Encoding
  1. 勾选 Files: Auto Guess Encoding。

或者在 settings.json 中开启

按 Ctrl + Shift + P，输入：

Preferences: Open User Settings (JSON)

然后加入：

{
  "files.autoGuessEncoding": true
}

如果你只想给当前项目开启，可以在项目根目录创建：

.vscode/settings.json

写入：

{
  "files.autoGuessEncoding": true
}

这样以后打开这个项目里的 INI，VSCode 会先尝试猜编码。

不过要记住：

自动猜测不是万能的。
文件太短、只有英文、混合编码时，它也可能猜错。
所以手动 Reopen with Encoding 仍然是终极方法。

五、到底该保存成什么编码？

这取决于这个 INI 是给谁用的。

1. 现代程序、跨平台、Git 项目

建议：

UTF-8 无 BOM

这是目前最通用的做法。

2. 老 Windows 程序、旧软件、某些游戏配置

建议：

保持原来的 GBK / GB18030 / ANSI

因为很多老程序读取 INI 时，仍然按系统 ANSI 代码页读。
你转成 UTF-8 后，VSCode 里看着正常，但程序可能读不到中文，甚至读不到配置。

3. 不确定给谁用

最稳的做法：

不要转，保持原编码。

只要 VSCode 里能正常显示、正常编辑就行。

4. 不要随便加 BOM

有些 INI 解析器不认 UTF-8 BOM，可能会导致第一个配置项读取出错。
所以给 INI 转 UTF-8 时，一般优先选：

UTF-8

而不是：

UTF-8 with BOM

除非你确认目标程序支持 BOM。

六、常见问题

Q1：为什么英文正常，中文乱码？

这是最典型的编码不匹配。
英文在 UTF-8 和 GBK 里大部分字节相同，所以看起来正常；中文字节不同，就会乱码。

Q2：为什么设置了 files.autoGuessEncoding 还是乱码？

因为自动猜测是概率判断，不是 100% 准确。
这时手动点右下角编码，选择 Reopen with Encoding，试 GB18030 或 GBK。

Q3：我已经在乱码状态下保存了，怎么办？

如果有 Git、备份、历史版本，赶紧恢复。
如果没有备份，可能很难恢复，因为原字节可能已经被覆盖。

Q4：转成 UTF-8 后，程序读不了配置了怎么办？

说明这个程序只认 ANSI/GBK。
把文件重新用 Save with Encoding 保存为 GB18030 或 GBK。

Q5：VSCode 默认编码能改成 GBK 吗？

可以，但不推荐全局改。
在 settings.json 里可以写：

"files.encoding": "gbk"

但这样会影响所有文件。
更好的方式是开启 files.autoGuessEncoding，遇到问题时手动切换。

七、懒人版解决流程

以后遇到 VSCode 打开 INI 乱码，按这个顺序来：

  1. 先备份文件。
  2. 设置里开启：
"files.autoGuessEncoding": true
  1. 重新打开 INI。
  2. 如果还乱码，点右下角编码。
  3. 选择 Reopen with Encoding。
  4. 优先试：
    • GB18030
    • GBK
    • UTF-16 LE
    • UTF-16 BE
  5. 中文正常后，判断这个 INI 给谁用。
  6. 现代程序可以转 UTF-8；老程序保持 GBK/ANSI。
  7. 不要在乱码状态下直接保存。

总结

VSCode 打开 INI 文件乱码，大多数时候不是文件坏了，而是：

文件编码和 VSCode 解码方式不一致。

记住两句话：

先 Reopen with Encoding，再 Save with Encoding。
不确定就保持原编码，别乱转 UTF-8。

再加上这个设置：

"files.autoGuessEncoding": true

以后遇到类似问题，基本都能快速解决。

avatar
文章
阅读
粉丝