VS Code 1.70+ 必须通过命令面板执行 Configure Display Language 设置界面语言，该命令自动校验语言包、生成合法 locale.json；手动配置 settings.json 的 "locale" 无效，且必须安装 Microsoft 官方中文语言包（ID：ms-ceintl.vscode-language-pack-zh-hans），locale.json 需置于用户级配置目录并严格遵循 JSON 格式，重启需彻底退出后台进程。
Configure Display Language 命令是唯一可靠入口
VS Code 1.70+ 版本已彻底弃用 settings.json 中的 "locale": "zh-cn" 配置，手动添加该字段完全无效。真正起效的只有通过命令面板执行 Configure Display Language，它会自动校验语言包、生成合法 locale.json 并写入正确路径。
常见错误包括：
- 在命令面板输错命令名，比如写成
Configure Language或Change Language - 从下拉列表中误选
zh-CN（大写 N）、zh_CN（下划线）或Chinese (Simplified)（文字项而非代码标识符） - 点了
Developer: Reload Window而非弹窗提示里的Restart—— 后者才触发全新进程初始化语言环境
必须装 Microsoft 官方中文语言包
扩展市场搜 chinese 会出现大量第三方插件，但只有作者为 Microsoft、ID 是 ms-ceintl.vscode-language-pack-zh-hans 的那个才完整覆盖菜单、状态栏、错误提示、内置扩展说明等全部 UI 元素。
装错的典型表现：
- 设置界面部分字段乱码或空白
- 右下角状态栏显示
en却无法切换 - 命令面板提示“Cannot read property 'translate' of undefined”
- 插件图标变灰，需右键启用后才能配合
Configure Display Language使用
locale.json 路径和格式不能手写
locale.json 必须位于用户级配置目录，且内容只能是严格 JSON 格式的一行：{"locale": "zh-cn"}。任何多余空格、注释、逗号或额外字段都会导致文件被静默忽略。
各系统路径必须准确：
- Windows：
%APPDATA%\Code\User\locale.json - macOS：
~/Library/Application Support/Code/User/locale.json - Linux：
~/.config/Code/User/locale.json
不要放在工作区目录（.vscode/locale.json），它不控制主界面语言；也不要试图用启动参数 code --locale=zh-cn，该方式在新版中已失效。
重启必须彻底退出后台进程
VS Code 的语言配置只在全新启动时读取 locale.json。如果只是点 Reload Window 或关闭窗口再重开，而后台仍有 Code.exe（Windows）或 Electron（macOS）残留进程，新窗口仍继承旧语言环境。
验证是否生效最直接的方式是看右下角状态栏：显示 en 就说明没成功。此时应手动杀掉所有相关进程，再重新启动 VS Code。
Remote-SSH 或 WSL 场景下，本地设置不会同步到远程实例，需单独在远程机器的 ~/.vscode-server/data/Machine/xxx/locale.json 中配置。
