vscode插件异常（如语言包不显示、git提交乱码）根本原因是底层编码链断裂，需分层修复：确认语言包启用并执行configure display language；对gbk文件先reopen再save as utf-8；禁用autoguessencoding；统一git/i18n/终端/node.js编码为utf-8。
VSCode插件本身不直接处理文件编码，但很多中文相关插件（比如 Chinese (Simplified) Language Pack、Prettier、ESLint、GitLens）会因编码配置错位而表现异常：语言包加载失败、注释高亮错乱、Git 提交信息显示为 ???、保存时自动插入 BOM。根本原因不是插件坏了，而是它们依赖的底层编码链被破坏了。
language pack 加载后 Configure Display Language 不显示 zh-CN
这是最典型的“假失效”：插件已启用，但命令面板里搜不到中文选项。核心问题在于 VS Code 启动时没完成语言包初始化，或被更高优先级配置锁死。
- 先确认扩展页中
Chinese (Simplified) Language Pack for Visual Studio Code状态为“启用”，且版本号 ≥1.89.2026052801（v1.89+ 强制要求 ozone 兼容） - 按
Ctrl+Shift+P运行Preferences: Configure Language，它会直接打开locale.json；若报错“文件不存在”，说明配置层被跳过，需手动在用户settings.json中加一行："locale": "zh-CN" - Windows 用户可查
%APPDATA%\Code\logs\main.log，搜索languagePack，若出现Failed to load language pack，大概率是插件下载不全 —— 删除%USERPROFILE%\.vscode\extensions\ms-ceintl.vscode-language-pack-zh-hans-*后重装
Change Encoding 插件批量转码后部分文件仍乱码
这类插件（如 Change Encoding、Encode Decode）能快速切换编码，但无法智能识别混合编码文件，尤其当项目里混有 .bat、.reg、.ini 等 Windows 原生依赖 GBK 的文件时，批量 Save as UTF-8 会导致执行失败。
- 别对整个工作区无差别转换；先用右下角点击编码 →
Reopen with Encoding逐个验证真实编码（优先试GBK、GB2312、UTF-8 with BOM） - 确认显示正常后，再点同位置 →
Save with Encoding→utf8（注意全小写、无短横、无 BOM）覆写 - 老项目建议按文件类型单独配：在
settings.json中用files.associations隔离，例如："[bat]": {"files.encoding": "gbk"}，避免全局"files.encoding": "utf8"污染
ESLint / Prettier 中文注释报错或格式化后变乱码
这不是插件逻辑错误，而是它们读取文件时用了错误的编码解码路径。ESLint 默认走 Node.js 的 fs.readFile，若文件实际是 GBK 但 VS Code 告诉它“这是 UTF-8”，就会把双字节汉字拆成非法序列，触发 InvalidCharacterError 或静默跳过。
- 确保文件本身已转为 UTF-8：右下角确认能
Reopen with Encoding → GBK显示正常后，必须执行Save with Encoding → utf8 - 关闭玄学猜测：
"files.autoGuessEncoding": false（写成字符串"true"会被完全忽略） - 检查 ESLint 配置是否硬编码了编码参数，比如某些旧版
.eslintrc.js里写了parserOptions: { ecmaVersion: 2020, sourceType: 'module', encoding: 'gbk' }—— 这种字段早已废弃，删掉
GitLens 提交记录中文显示为 或空格
GitLens 从 Git 命令行拉取 log 信息，而 Git 默认不强制 UTF-8 输出。Windows 上尤其明显：git config 的 i18n.commitencoding 若未设为 utf-8，或终端当前代码页是 936（GBK），GitLens 就会拿到一堆无法解析的字节。
- 运行
git config --global i18n.commitencoding utf-8 - 同时设
core.quotepath false（避免路径名被转义）：git config --global core.quotepath false - VS Code 终端内运行
git log --oneline确认中文正常后再看 GitLens 面板；若终端里也不正常，说明是 shell 层问题，需补"terminal.integrated.env.windows": {"PYTHONIOENCODING": "utf8", "LC_ALL": "zh_CN.UTF-8"}
真正麻烦的不是某个插件不兼容，而是你改了 settings.json 却没意识到 VS Code 有 4 层编码控制：文件读取、文件写入、终端环境、Node.js 运行时。它们各自独立，又互相影响。一个 utf8 写成 UTF-8，或漏掉一个 false 的布尔值，就足以让所有插件集体“失语”。
