VSCode中文注释乱码八成是UTF-8解码GBK文件所致，须先右下角点编码→选Reopen with Encoding→试GBK确认真实编码，再Save with Encoding→UTF-8转存，禁用files.autoGuessEncoding，按后缀用files.associations精准设gbk。
VSCode里中文注释乱码，八成不是文件坏了，而是你正用 UTF-8 解码一个实际是 GBK 的文件——直接改设置或装插件不解决问题，得先确认真实编码、再分层处理。
怎么快速判断一个文件是不是 GBK 编码？
别靠猜。Windows 上双击记事本保存的 .txt/.py/.reg 文件，90% 是 GBK（即 CP936）；但 VSCode 不会告诉你，它只会默默显示方块或 \u4f60\u597d 这类转义。
- 在终端执行
file -i filename.py（macOS/Linux）或enca -L zh filename.py（需先choco install enca或brew install enca） - 如果输出含
charset=gbk、charset=cp936或encoding=GBK，就坐实了 - VSCode 右下角点编码 → 选
Reopen with Encoding→ 试GBK，文字立刻正常？那也基本可定 - 注意：
files.autoGuessEncoding对 GBK 几乎无效，别指望它自动识别成功
单个文件转码：为什么必须分两步做？
Reopen with Encoding 和 Save with Encoding 是两个完全独立的动作，混用等于白干。
-
Reopen with Encoding：只改当前 VSCode 怎么读这个文件，磁盘字节原封不动，安全可逆 -
Save with Encoding：把编辑器里“现在看到的内容”，按你选的编码（如UTF-8）重新写回硬盘——这才是真转码，字节变了 - 错误操作示例：乱码时直接点右下角 → 选
UTF-8（没点Reopen），结果满屏方块——那是 VSCode 强行用 UTF-8 解释 GBK 字节，不是切换，是错解 - 正确流程：先
Reopen with Encoding → GBK（确认能看）→ 再Save with Encoding → UTF-8（真正存成 UTF-8）
批量转 GBK 到 UTF-8：为什么别信 VSCode 插件？
所谓“一键转全部”的插件（如 GBK to UTF8 for vscode），底层只是循环调用 Reopen + Save，一旦某个文件识别失败，就静默损坏，且无法回滚。
- Windows 推荐 PowerShell +
iconv（需先choco install iconv）：Get-ChildItem *.py,*.txt | ForEach-Object { iconv -f GBK -t UTF-8 $_.FullName | Set-Content "$($_.DirectoryName)\$($_.BaseName)_utf8$($_.Extension)" -Encoding UTF8 } - macOS/Linux 直接用：
find . -name "*.py" -exec iconv -f GBK -t UTF-8 {} -o {}.utf8 \; - 关键前提：先用
file或enca扫一遍目录，确认全是 GBK；混合编码项目必须分批处理，否则一个文件错判，整批报废 - 转完记得删掉旧文件、重命名新文件，别留
.utf8后缀——Git 会把它当新文件，历史记录全断
老项目不敢动全局设置？用 files.associations 精准控制
全局设 "files.encoding": "utf8" 对新项目很稳，但对遗留 .bat、.reg、.ini 文件就是灾难——它们依赖 GBK 执行，改成 UTF-8 后双击就报错。
- 打开命令面板
Ctrl+Shift+P→ 输入Preferences: Configure Language Specific Settings→ 选Plain Text - 在弹出的 language-specific settings 块里加：
"files.encoding": "gbk" - 或者更细粒度，在
settings.json里写："files.associations": { "*.bat": "gbk", "*.reg": "gbk", "*.ini": "gbk" } - 这样只有匹配后缀的文件走 GBK，其他（如
.py、.js）仍按全局utf8处理，互不干扰
最易被忽略的一点：转完 UTF-8 后，务必检查有没有 BOM。VSCode 默认保存无 BOM 的 UTF-8，但某些工具（尤其是 Python 解释器）遇到带 BOM 的文件会报 SyntaxError: Non-UTF-8 code starting with '\xef'。别手抖选 UTF-8 with BOM。
