中文插件装完界面仍是英文，需手动执行Configure Display Language命令并选zh-cn后重启；若仍无效，检查locale.json内容或在settings.json中用override locale强制设置。
中文插件装完界面还是英文？检查 Configure Display Language 是否选了 zh-cn
装完 Chinese (Simplified) Language Pack for Visual Studio Code 后界面没变，大概率是漏掉了语言切换这步。VSCode 不会自动启用中文，必须手动触发命令面板执行配置。
常见错误现象：插件已安装但菜单、设置项、报错提示全是英文；或者重启后又回退成英文。
- 按
Ctrl+Shift+P（Mac 用Cmd+Shift+P），输入Configure Display Language，回车 - 在弹出列表中确认选中的是
zh-cn，不是zh或其他变体 - 必须点击「Restart」按钮，仅关闭再打开窗口无效
- 如果重启后仍为英文，检查
%USERPROFILE%\AppData\Roaming\Code\User\locale.json（Windows）或~/Library/Application Support/Code/User/locale.json（macOS）里是否为{"locale":"zh-cn"}
locale.json 被覆盖怎么办？禁用自动语言检测
某些系统或远程开发环境（比如 WSL、SSH 远程连接）会强制同步系统语言设置，导致 locale.json 被重写为 en-us。
使用场景：你在 Windows 主机上配好中文，但一连 WSL 就变英文；或者用 Codespaces / Dev Container 时反复失效。
- 打开 VSCode 设置（
Ctrl+,），搜索display language - 勾选
Display Language > Override Locale，并填入zh-cn - 该设置会写入
settings.json，优先级高于locale.json，可对抗自动覆盖 - 若用 Dev Container，需在
.devcontainer/devcontainer.json中加："remoteEnv": {"VSCODE_LANG": "zh-cn"}
中文字体模糊、标点错位？改 editor.fontFamily 加 fallback
中文显示发虚、顿号句号挤在一起、等宽字体里中文宽度异常——不是插件问题，是字体链没配对。
典型表现：代码里中文注释字间距不均；终端输出中文字符重叠；括号、引号渲染变形。
- 在
settings.json中设置："editor.fontFamily": "'Fira Code', 'Microsoft YaHei', 'PingFang SC', 'sans-serif'" - 务必把等宽编程字体（如
Fira Code）放最前，中文字体（Microsoft YaHei或PingFang SC）紧随其后作 fallback - 避免只写
"Microsoft YaHei"—— 它不是等宽字体，会导致缩进错乱 - Linux 用户可用
Noto Sans CJK SC替代，需提前sudo apt install fonts-noto-cjk
插件更新后中文菜单突然乱码？清缓存比重装更有效
2026 年 5 月起，部分用户反馈升级插件后出现菜单文字方块、设置页空白、右键菜单乱码等问题，根源多是 VSCode 渲染层缓存损坏。
这不是语言包故障，重装插件无用；也和系统字体无关，不用动注册表或 fontconfig。
- 关闭所有 VSCode 窗口（包括托盘进程）
- 删除缓存目录：
Windows：%APPDATA%\Code\Cache
macOS：~/Library/Caches/com.microsoft.VSCode
Linux：~/.config/Code/Cache - 重新启动 VSCode，首次加载稍慢，但中文渲染立即恢复正常
- 若仍有问题，临时禁用所有非必要插件，再逐个启用排查冲突
