根本原因是未执行configure display language命令——该命令是vs code 1.70+唯一合法路径，其他操作（改settings.json、reload、手动写locale.json）均无效；必须安装官方包ms-ceintl.vscode-language-pack-zh-hans，通过命令面板输入全名、选zh-cn、点restart才能生效。
VSCode 设置中文包后无法无缝切换，根本原因不是“没装对”，而是“没走对路径”——官方只认 Configure Display Language 这一条命令，其他任何操作（改 settings.json、点 Reload、手动写 locale.json）在 VS Code 1.70+ 版本中都只是临时补丁，重启即失效。
必须安装 Microsoft 官方语言包 ms-ceintl.vscode-language-pack-zh-hans
第三方插件如 Chinese Language Pack 或带 “Pro” 字样的汉化包，会导致命令面板乱码、报错 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 - 点击 Install 后，**必须等右下角弹出提示，且点 “Change and Restart”**；仅点 “Reload” 不生效
Configure Display Language 命令必须输全名并选 zh-cn
该命令不是可选项，而是唯一写入生效配置的入口。常见错误包括：
- 输成
configure language、set language或漏掉空格，命令面板不识别 - 在下拉列表中选 “Chinese (Simplified)” —— 无效，必须选代码值
zh-cn（小写 + 短横线，zh_CN、Zh-cn、Chinese全部失败） - 选完后弹窗提示 “Restart window?”，必须点 Yes；点 “No” 或关闭弹窗，
locale.json不会生成或更新
远程开发（SSH/WSL）下中文不生效，是因为 locale 配置没同步到服务端
本地设好中文，连上 Remote-SSH 或 WSL 后界面仍是英文？因为 VS Code Server 在远程机器上独立运行，它读的是远程路径下的 locale.json，而非你本地的配置。
- Windows 本地路径：
%APPDATA%\Code\User\locale.json - Linux/macOS 远程路径：
~/.config/Code/User/locale.json - 解决方法：在远程实例中重复执行
Configure Display Language→ 选zh-cn→ 重启远程窗口；或者手动在远程机器上创建locale.json，内容为{"locale":"zh-cn"}
部分菜单/插件仍显示英文，这不是设置失败，而是正常现象
VS Code 本体语言切换只影响核心 UI（菜单栏、侧边栏、命令面板、设置页），不强制汉化第三方插件。例如：
-
Python、Remote-SSH、GitLens等插件的界面语言由各自维护，需单独查看其文档是否支持中文 - 某些插件即使支持，也要等其主动适配新版本的 VS Code 语言 API，滞后是常态
- 文件内容编码（如
GBK）、终端字体（未配Microsoft YaHei UI）也会导致“看起来像没切成功”，但实际只是渲染问题
最常被忽略的一点：VS Code 的语言切换是进程级的，不是会话级的。哪怕你改了 locale.json，只要没触发全新进程启动（即完整重启），就不会读取新值。很多人卡在这一步，反复 reload 却始终是英文界面。
