最可靠做法是关闭文件标签页后重新双击打开,再通过右下角选“Reopen with Encoding”尝试GBK或UTF-8 with BOM;对Excel导出CSV、.reg文件等,UTF-8 with BOM常为正确选项。

点完 Reopen with Encoding 还是乱码?先关文件重开
VSCode 的 Reopen with Encoding 不会“覆盖式重载”,它依赖当前文件句柄状态。如果文件已打开、内容被缓存,或编辑器内部解码失败后残留了错误 Unicode 替换字符(如 ),直接切换编码可能无效——字节流没变,但内存里已是损坏的字符串。
最可靠的做法是:关闭该文件标签页 → 重新用资源管理器双击打开 → 再点右下角编码名 → 选 Reopen with Encoding → 尝试 GBK 或 UTF-8 with BOM。尤其对 Excel 导出的 CSV、注册表文件(.reg)或微信粘贴文本,UTF-8 with BOM 是高频正确选项。
- 别在乱码状态下反复点击不同编码——无效操作会固化错误渲染
- 如果选
GBK后更乱,不是“再试一次 GB2312”,而是立刻关掉重来,否则可能把 当作有效字符参与后续解码 - 记事本保存的纯文本,优先试
GBK;Notepad++ 或 Sublime 保存的,优先试UTF-8(无 BOM)
Save with Encoding → UTF-8 后反而报错?你点了 “with BOM”
Python 报 SyntaxError: Non-UTF-8 code starting with '\xef'、Git diff 出现 ^@、Node.js require() 失败——这些全是 UTF-8 with BOM 的典型症状。VSCode 在弹窗里把 UTF-8 和 UTF-8 with BOM 并列显示,但它们是两个完全不同的编码选项。
UTF-8 with BOM 会在文件开头硬塞入 \ufeff(即字节 EF BB BF),而 Python 解释器、Git、ESLint 等工具默认拒绝处理这个前缀。真正该选的是纯 UTF-8(不带任何修饰词)。
- 确认方法:保存后用
xxd或 Notepad++ 的“编码”菜单查看实际编码,或执行file -i filename.py(Linux/macOS) - 修复方法:重新打开文件 →
Reopen with Encoding→UTF-8 with BOM→ 全选内容复制 → 新建空白文件 → 粘贴 →Save with Encoding→UTF-8 - 别依赖“自动保存为 UTF-8”:VSCode 不会主动剥离 BOM,它只按你点的那个选项原样写入
为什么改了 settings.json 的 files.encoding 还是没用?它只管“新文件”
"files.encoding": "utf8" 这个配置项只影响三类场景:新建空文件、未被打开过的无 BOM 文件、以及通过命令面板创建的文件。它对已存在的文件完全不生效——VSCode 会忠实记住你上次用什么编码打开它,并把这个偏好存在工作区或用户缓存中。
想让某个 .py 或 .txt 永远用 UTF-8 打开,唯一办法是:先用正确编码(比如 GBK)把它恢复显示 → 再执行 Save with Encoding → UTF-8 → 关闭重开验证。这时 VSCode 才把“这个文件 = UTF-8”写进本地缓存。
- 配置值必须是
"utf8"(全小写、无短横、无 BOM),写成"UTF-8"或"UTF8"会被静默忽略 - 老项目混有
.bat或.reg?别全局设死utf8,改用"files.associations": {"*.bat": "gbk"}单独指定 - 多语言项目(如 Java + Shell + PowerShell)建议分层配:用户级关
files.autoGuessEncoding,工作区级按后缀配,语言级用"[java]": {"files.encoding": "utf8"}
终端 print("中文") 是方块?和文件编码无关,是代码页问题
编辑器里文件显示正常,但集成终端运行 Python 输出中文变成方块或问号——这跟 files.encoding 设置毫无关系。根本原因是 Windows 控制台(ConPTY)默认使用 GBK(代码页 936)解码输出流,而 Python 默认按系统 locale 输出 UTF-8 字节,两者错配。
临时解决:在终端里手动执行 chcp 65001 切到 UTF-8 代码页;永久解决需两步走:一是设置环境变量 PYTHONIOENCODING=utf8,二是确保 PowerShell 配置里写了 $OutputEncoding = [Console]::OutputEncoding = [System.Text.Encoding]::UTF8。
- VSCode 设置中加
"terminal.integrated.env.windows": {"PYTHONIOENCODING": "utf8"}只影响集成终端,不影响外部 PowerShell - 字体不是主因:Consolas、Cascadia Code、Fira Code 都支持中文,只要代码页对了,方块就消失
- SSH 或 WSL 终端乱码?那是远程端的 locale 和
LANG设置问题,和 VSCode 本地配置无关
Save with Encoding。想一劳永逸,不是调配置,而是对关键文件逐个“确认并固化”编码偏好。


















