VSCode中文界面不报错，所谓“报错”实为配置冲突或缓存残留导致的本地化链路中断；需检查displayLanguage覆盖、清理CachedData缓存、确认语言包启用，并区分界面语言与源码编码。
VSCode 中文界面本身不会报错，所谓“中文界面报错”，90% 是指安装或切换中文语言包后出现功能异常、界面不生效、启动失败，或错误日志里出现与 locale、displayLanguage、zh-cn 相关的加载失败信息。这不是 VSCode 原生 bug，而是配置冲突或缓存残留导致的本地化链路中断。
中文语言包安装后界面仍是英文？检查 displayLanguage 配置是否被覆盖
VSCode 启动时会按顺序读取语言设置：用户 settings.json > 工作区 settings.json > 系统默认。如果工作区设置了 "displayLanguage": "en"，它会强制覆盖全局中文配置。
- 按
Ctrl+Shift+P（macOS 为Cmd+Shift+P）打开命令面板，输入Configure Display Language并执行 - 确认弹出的选项中已选中
zh-cn；若未出现，说明语言包未成功安装或被禁用 - 手动检查
settings.json：搜索displayLanguage和locale，删除或注释掉任何值为"en"、"en-us"的行 - 重启 VSCode 后仍无效？尝试在命令面板运行
Developer: Inspect Editor Tokens and Scopes，看当前 editor 是否识别为中文环境（部分插件依赖此信号）
main.log 里出现 Failed to load locale zh-cn？优先清空 CachedData
这个错误表明 VSCode 尝试加载中文资源包时找不到对应文件，常见于升级后缓存未刷新、语言包下载中断、或磁盘权限异常。它和插件崩溃不同，不触发崩溃报告，但会导致界面回退到英文。
- 关闭所有 VSCode 实例
- 定位缓存目录：
Windows：%APPDATA%\Code\CachedData
macOS：~/Library/Application Support/Code/CachedData
Linux：~/.config/Code/CachedData - 删除整个
CachedData文件夹（不是里面的内容，是文件夹本身） - 重新启动 VSCode —— 它会自动重建缓存并重试加载语言包
- 如果仍报错，再检查
Extensions视图中 “Chinese (Simplified) Language Pack for VS Code” 是否处于启用状态（右下角无禁用图标）
终端里编译 Java/C++ 含中文时报错，和 VSCode 中文界面无关
这是高频误解。VSCode 界面语言设为中文，**完全不影响**你项目中源码文件的编码、编译器的默认字符集、或终端的显示编码。报错如 error C2001、unmappable character 或输出乱码，根源全在工程级编码配置，而非编辑器 UI。
- Java 编译：必须在
tasks.json的args中显式加"-encoding", "UTF-8"，或设环境变量JAVA_TOOL_OPTIONS="-Dfile.encoding=UTF-8" - C++（MinGW/MSVC）：文件保存编码需与编译器预期一致。右下角点击
UTF-8→ 选Save with Encoding→ 改为GBK（仅限 Windows 传统控制台），或统一用UTF-8 with BOM并配chcp 65001 - 终端显示：VSCode 集成终端默认继承系统 locale，Windows 用户需在终端里先执行
chcp 65001，macOS/Linux 则确保LANG环境变量含UTF-8
真正难排查的是多层编码叠加：比如文件存为 UTF-8，javac 按 GBK 解析，VSCode 终端又用 UTF-8 渲染——此时错误日志里根本不会提“中文”，只报语法错误。务必分清「界面语言」和「数据编码」是两个正交维度，混在一起查日志只会绕远路。
