configure display language 命令必须重启 vscode 才生效，仅修改 locale.json 或安装中文语言包而不重启将导致界面仍为英文；需安装 microsoft 官方简体中文语言包并执行该命令后重启，终端及调试信息等外部内容不受影响。
Configure Display Language 命令必须重启才生效
VSCode 的界面语言切换不是实时刷新的，Configure Display Language 命令选完 zh-cn 后，它只会写入配置并弹出提示——**必须点 Restart 或手动关闭再启动，否则界面上一个中文都不会出现**。很多人卡在这一步，反复切换、重装语言包都没用，其实只是没重启。Windows/macOS/Linux 全部适用，没有例外。
常见错误现象：
- 命令面板里选了
zh-cn，点了确认，窗口没关，菜单还是英文 - 设置里改了
locale，保存后直接点右上角 × 关掉设置页，以为生效了 - 远程开发（SSH/WSL）连接中执行该命令，只重启了本地窗口，远程会话仍是英文
locale.json 文件路径和内容必须严格匹配
当命令面板不可用（比如插件崩溃、UI 卡死），或想批量部署时，得手动编辑 locale.json。这个文件位置因系统而异，但内容格式极其固定：
Windows：%APPDATA%\Code\User\locale.json
macOS：~/Library/Application Support/Code/User/locale.json
Linux：~/.config/Code/User/locale.json
文件内容只能是这一行 JSON：
{"locale":"zh-cn"}
注意以下细节：
- 不能多空格、不能换行、不能加注释（JSON 不支持）
- 键名必须是
locale，不是language或displayLanguage - 值必须是字符串
"zh-cn"，不是zh_CN、zh或Chinese - 如果文件不存在，需手动创建；如果存在但内容错误，直接覆盖即可
中文语言包必须装 Microsoft 官方版
在扩展市场搜 Chinese 会出现一堆结果，但只有作者是 Microsoft 的那个叫 Chinese (Simplified) Language Pack for Visual Studio Code 才能保证完整汉化。第三方“汉化插件”多数只改菜单名或加几个翻译项，不参与 VSCode 底层语言资源加载流程，装了也白装。
安装后仍不生效的典型原因：
- 装了但没重启 VSCode（最常见）
- 装了但没运行
Configure Display Language切换到zh-cn（语言包 ≠ 自动启用） - VSCode 版本太老（
1.70以下对新语言包兼容性差，建议升级到1.85+） - 使用了 Portable 模式且用户数据目录被重定向，导致
locale.json写错位置
终端、调试控制台、报错信息为什么还是英文
这是最容易产生误解的地方：VSCode 界面变成中文，不代表你写的代码、终端输出、编译器报错、Python/Pylint 提示也会变中文。这些内容来自外部进程或插件，和 locale.json 无关。
例如：
- 终端里运行
gcc报错，取决于系统LANG环境变量，不是 VSCode 控制的 - Python 插件的 lint 错误，取决于
pylint是否内置中文翻译，跟 VSCode 语言设置无关 - 调试面板里的变量类型、调用栈，由 C/C++ 或 Python 调试器提供，它们默认走英文本地化
所以看到终端里满屏 error: expected ';' before '}' token，别怀疑汉化失败——这才是正常状态。真要改这些，得单独配置对应工具链的语言环境，不是 VSCode 能管的。
