VS Code UTF-8 编码设置指南（解决乱码问题）

🧠 VS Code UTF-8 编码设置指南（解决乱码问题）

在日常开发中，很多人都会遇到一个烦人的问题：中文乱码。
尤其是在使用 VS Code 打开文件时，经常会看到一堆“？？？”或者奇怪符号。

这篇文章带你一次性搞懂：

• 什么是 UTF-8
• VS Code 如何正确设置 UTF-8
• 如何解决乱码问题

📌 一、什么是 UTF-8？

UTF-8 是一种字符编码格式，用于表示文本（尤其是多语言，比如中文、日文等）。

👉 简单理解：

⚠️ 问题的本质：
👉文件编码 ≠ 编辑器解码方式 → 就会乱码

⚙️ 二、VS Code 设置默认 UTF-8

方法一：图形界面（推荐）

1. 打开 VS Code
2. 按快捷键：

Ctrl + ,

3. 在搜索框输入：

encoding

4. 找到：

👉Files: Encoding

5. 设置为：

utf8

🔍 三、开启自动识别编码（强烈推荐）

继续在设置里搜索：

auto guess

找到：

👉Files: Auto Guess Encoding

✔ 勾选开启

为什么要开？

因为很多旧文件不是 UTF-8，比如：

• GBK（常见于 Windows）
• Shift-JIS（日文）

开启后 VS Code 会自动帮你识别，减少乱码问题。

📄 四、针对单个文件修改编码

如果已经乱码了，可以这样处理：

1. 打开文件
2. 看右下角（显示编码，比如UTF-8/GBK）
3. 点击它

会弹出两个选项：

🔄 Reopen with Encoding（重新打开）

👉 用正确编码读取文件（不修改文件本身）

💾 Save with Encoding（保存为）

👉 转换成 UTF-8

💻 五、终端乱码问题（Windows）

如果你在 VS Code 终端看到乱码：

执行：

chcp65001

👉 切换终端到 UTF-8

⚠️ 六、常见坑总结

❌ 1. UTF-8 vs UTF-8 with BOM

• UTF-8（推荐）
• UTF-8 with BOM（有些工具会出问题）

👉 建议：统一使用UTF-8（无 BOM）

❌ 2. 文件本身不是 UTF-8

比如：

• Excel 导出的 CSV（常是 GBK）
• 老项目代码

👉 解决方法：

Reopen with Encoding → GBK → 再 Save with Encoding → UTF-8

❌ 3. Git 导致乱码

跨平台开发时：

• Windows（GBK）
• Mac/Linux（UTF-8）

👉 建议：

gitconfig--globalcore.autocrlf input

并统一项目编码为 UTF-8

🚀 七、最佳实践（推荐配置）

{"files.encoding":"utf8","files.autoGuessEncoding":true}

🎯 总结

遇到乱码，记住这三步：

1. 确认文件编码
2. 用正确编码重新打开
3. 统一保存为 UTF-8

💬 最后

UTF-8 是现代开发的“默认语言”，
统一编码 = 少踩 90% 的坑。