VSCode中文界面不生效的主因是locale未激活、进程残留或字体链缺失；须安装微软官方语言包ms-ceintl.vscode-language-pack-zh-hans，执行Configure Display Language选zh-cn并重启，或手动编辑UTF-8无BOM的locale.json为{"locale":"zh-cn"}。
VSCode中文界面不生效，90%不是插件没装，而是locale没激活、进程没杀干净、或字体链没兜底——装完插件点“重载窗口”基本白忙。
必须安装 Microsoft 官方语言包 ms-ceintl.vscode-language-pack-zh-hans
搜“中文”“汉化”大概率装错。第三方插件（如Chinese Language Pack、VSCode Chinese）只改菜单栏几个字，命令面板、设置项、错误提示仍是英文，还可能报Cannot read property 'translate' of undefined。
- 按
Ctrl+Shift+X打开扩展面板，**严格粘贴全名**搜索：Chinese (Simplified) Language Pack for Visual Studio Code - 认准发布者是 Microsoft、带蓝勾认证图标、扩展 ID 是
ms-ceintl.vscode-language-pack-zh-hans - 安装后右下角弹出
Restart Now提示——必须点它；Reload Window不触发语言切换
必须执行 Configure Display Language 并选 zh-cn
语言包只是翻译资源，“用哪套”由这个命令控制。它不接受任何变体，且不报错——输错就静默维持英文。
- 按
Ctrl+Shift+P呼出命令面板，输入完整命令：Configure Display Language（不是Change Language或Set Locale） - 从下拉列表中**手动滚动找到并选中
zh-cn**（全小写、短横线；zh_CN、zh-hans、Chinese全无效） - 弹窗提示“需要重启窗口”，必须点
Restart；点了Later或关掉弹窗，配置不会写入locale.json
手动编辑 locale.json 是最稳的兜底方式
当命令面板卡死、反复切换失败、或公司内网无法访问扩展市场时，直接覆盖配置文件绕过 UI 层。它的优先级高于所有设置，且不依赖插件状态。
- 先彻底退出 VS Code：Windows 查任务管理器杀光所有
Code.exe；macOS 用pkill -f "Electron.*Code"；Linux 用pkill -f "code.*--no-sandbox" - 打开对应路径的
locale.json文件：
Windows：%APPDATA%\Code\User\locale.json
macOS：$HOME/Library/Application Support/Code/User/locale.json
Linux：$HOME/.config/Code/User/locale.json - 文件内容**仅且只能有一行**：
{"locale":"zh-cn"}，保存为 UTF-8 无 BOM 编码（用 VS Code 自己打开编辑，右下角确认显示UTF-8）
中文显示发虚、终端乱码、注释方块？那是字体和编码没配对
主界面变中文 ≠ 所有模块都中文。终端、调试控制台、Git 输出、插件 WebView 页面默认不随 locale 变——它们各自走独立语言环境。
- 编辑器中文发虚：检查
editor.fontFamily字体链顺序，西文字体必须在前，中文字体兜底，例如："Fira Code", "JetBrains Mono", "Microsoft YaHei", "PingFang SC" - 集成终端中文变方块：
editor.fontFamily对终端完全无效，需单独设terminal.integrated.fontFamily，并加chcp 65001强制 UTF-8 - 部分插件（如
GitLens）需单独配置gitlens.language才能汉化，和主界面语言无关
真正容易被忽略的是：locale.json 的路径层级、UTF-8 无 BOM 编码格式、以及后台残留进程导致新窗口复用旧语言环境——这不是配置失败，而是进程没杀干净。
