必须安装microsoft官方中文语言包并设locale为zh-cn，重启vs code生效；终端和调试控制台保持英文属正常，远程开发需单独配置远程机器locale.json。
装对插件：只认 Microsoft 官方语言包 ID
VS Code 中文界面失效，八成是因为装了假“中文插件”。搜索“汉化”“中文菜单”“VSCode Chinese”等关键词，大概率会装到非官方、已停更甚至带副作用的第三方扩展。这些插件不提供完整语言资源，反而可能破坏 locale.json 读取逻辑，引发 Cannot read property 'translate' of undefined 或命令面板空白。
必须安装的唯一扩展是：
– 名称：Chinese (Simplified) Language Pack for Visual Studio Code
– 发布者：Microsoft
– 扩展 ID：ms-ceintl.vscode-language-pack-zh-hans
在扩展面板（Ctrl+Shift+X）中粘贴全名搜索，认准蓝勾认证图标。安装后右下角必须点 Restart Now —— 不是“关闭再打开”，也不是 Developer: Reload Window，后者不重载语言资源。
设对 locale：zh-cn 是唯一有效值
Configure Display Language 命令不是“选完就生效”，它只是写入配置；真正起作用的是 {"locale":"zh-cn"} 这个值，且格式极其严格：
-
zh-cn✅（全小写、单连字符，2026 年唯一被识别的写法） -
zh_CN❌、zh-CN❌、ZH-CN❌、zh❌ —— 全部静默失败，无报错提示
执行该命令后若仍为英文，大概率是没点重启，或点了但后台还有残留进程。Windows 需查任务管理器杀掉所有 Code.exe；macOS 要在活动监视器里结束 Code Helper；Linux 可用 pkill -f code。
手动编辑 locale.json 是最稳兜底方式
当命令面板卡死、插件市场无法访问、或切换后始终无效时，直接编辑配置文件是最可靠路径。VS Code 从 2026 年起已移除 settings.json 中的 locale 字段，只认以下路径的 locale.json：
– Windows：%APPDATA%\Code\User\locale.json
– macOS：$HOME/Library/Application Support/Code/User/locale.json
– Linux：$HOME/.config/Code/User/locale.json
用 VS Code 自己打开并编辑该文件，内容仅一行：{"locale":"zh-cn"}，保存时务必确认右下角状态栏显示 UTF-8（无 BOM） —— 用记事本或 Sublime 保存极易带 BOM，导致文件被忽略。
终端和调试控制台仍是英文？这不是配置失败
顶部菜单、设置导航栏、命令面板提示变成中文，就说明主界面汉化成功。而终端（Terminal）、调试控制台（Debug Console）、Git 输出、部分插件弹窗显示英文，是正常行为：
– 终端语言取决于系统 shell（如 PowerShell、zsh）的 LANG 或 LC_ALL 环境变量，VS Code 不接管
– 调试面板中的变量名、堆栈、错误信息来自运行时（Node.js、Python 解释器等），由其自身本地化逻辑决定
– 想让调试日志更易读，可在 launch.json 中加："env": {"LANG": "zh_CN.UTF-8"}（仅限 Linux/macOS）
真正容易被忽略的是：Remote-SSH 或 WSL 场景下，远程实例的 locale.json 是独立的，需去远程机器的 ~/.vscode-server/data/Machine/xxx/locale.json 单独配置。
