Configure Display Language 命令是语言切换唯一有效入口,settings.json 中的 "locale" 已弃用;必须通过该命令生成/修改 locale.json,并安装官方 Chinese (Simplified) Language Pack 才能生效。

Configure Display Language 命令才是语言切换的唯一入口
VS Code 从 1.70 版本起,settings.json 中的 "locale": "zh-cn" 配置已被完全弃用。你改了它,VS Code 启动时会静默忽略——不报错、不警告、也不生效。真正起效的只有 locale.json 文件,而它必须由 Configure Display Language 命令生成或修改。
这个命令会自动做三件事:检查是否已安装对应语言包、跳转安装页(如未装)、打开正确的 locale.json 路径并预填值。手动编辑文件容易写错路径或格式,不如直接走命令面板。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS) - 输入并选择
Configure Display Language - 在弹出列表中选
zh-cn(注意是小写、短横线,不是zh_CN或Chinese) - 看到提示后,点
Restart—— 不是Reload Window,也不是关标签页
必须安装 Microsoft 官方 Chinese (Simplified) Language Pack
语言包不是可选配件,而是翻译资源的“字典”。没它,locale.json 就是空开关。VS Code 只认一个 ID:ms-ceintl.vscode-language-pack-zh-hans,发布者必须是 Microsoft。
别信名字带“汉化”“Pro”“Ultimate”的第三方包——它们不更新、不覆盖设置页、有的还会注入脚本。搜索时务必粘贴全名:Chinese (Simplified) Language Pack for Visual Studio Code,认准蓝白 logo + “中”字图标。
- 按
Ctrl+Shift+X打开扩展面板 - 严格粘贴上述全名,只装搜索结果里作者为 Microsoft 的那个
- 安装完不要点右上角的
Reload按钮——那只是重载扩展,不触发语言切换 - 装完立刻执行
Configure Display Language命令,否则界面仍是英文
locale.json 路径和内容必须精准匹配
VS Code 只读用户级 locale.json,且只在启动时加载一次。改完文件不重启 = 白改。工作区目录下的 .vscode/locale.json 是无效的,系统级或环境变量(如 VSCODE_LANG=en)也会强行覆盖你的配置。
正确路径(务必确认你改的是这个):
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
文件内容只能是合法 JSON,且仅含一个字段:
{"locale":"zh-cn"}
多一个逗号、少一个引号、写成 "zh_CN" 或 "zh",都会导致失败。如果文件不存在,直接新建即可,VS Code 启动时会识别。
重启窗口是硬性要求,不是建议
语言包没有运行时热更新机制。所谓“重载窗口”(Developer: Reload Window)只刷新 UI 组件,不重新加载本地化资源。很多用户卡在这一步:点了 Reload,界面还是英文,然后怀疑插件没装好、路径写错了、甚至重装 VS Code……其实就差一次完整重启。
注意“重启窗口”的真实含义:
- 关闭所有 VS Code 窗口(包括后台托盘进程)
- 确保任务管理器 / 活动监视器里没有残留的
Code进程 - 再双击图标或命令行启动
- 启动后右下角状态栏点 locale 显示应为
zh-cn,且可点击切换
最容易被忽略的是:某些 Linux 发行版的 Snap 版 VS Code 因沙盒限制无法加载语言包,此时换用 .deb 或 tarball 官方包才能解决。


















