VSCode 中文界面不生效的主因是 locale 配置未正确写入 locale.json 文件。需通过 Configure Display Language 命令选择 zh-cn 并重启,或手动在对应系统路径下创建合法 JSON 格式 locale.json({"locale":"zh-cn"}),并确保安装官方中文语言包。

VSCode 界面中文不生效,90% 是因为 locale 配置没落到正确位置,而不是语言包没装对。 官方从 VS Code 1.70 开始彻底弃用 settings.json 中的 "locale": "zh-cn",只认专用的 locale.json 文件——它必须存在、路径准确、内容合法,且编辑器进程必须完整重启。
Configure Display Language 命令是首选入口
这是最可靠、容错性最高的设置方式,绕过手动路径判断和文件编辑风险:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入并选择
Configure Display Language(注意不是Configure Language或Open Settings) - 在下拉列表中直接点击
zh-cn(小写、短横线;zh_CN、zh-CN、Chinese全部无效) - 看到提示后必须点
Restart,仅Reload Window不够——部分 UI 组件依赖完整进程初始化
locale.json 文件路径与格式必须严格匹配
当命令面板打不开、反复切回英文、或 Remote-SSH/WSL 场景失效时,手动创建 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"},不能有注释、多余空格、尾随逗号或 BOM 头 - 编辑前务必关闭所有 VS Code 窗口,包括后台
Code.exe/Code Helper进程(Windows 可查任务管理器)
中文语言包必须是 Microsoft 官方发布的
第三方“中文插件”大多只改几个菜单项,翻译不全、长期不更新,甚至破坏设置同步。VS Code 的中文界面依赖的是官方语言包提供的完整资源映射表:
- 在扩展面板(
Ctrl+Shift+X)搜索Chinese (Simplified) Language Pack for Visual Studio Code - 认准发布者是
Microsoft,ID 为ms-ceintl.vscode-language-pack-zh-hans - 安装后界面仍为英文?不是包没装好,而是没执行上一步的
Configure Display Language——语言包只是“字典”,还没被调用 - 若安装后无重启提示,可能是网络中断或缓存异常:可尝试
code --disable-extensions启动后重试
右下角弹窗“Change Language and Restart”只改当前窗口
这个按钮最容易被误认为是全局设置,但它只影响当前窗口语言,新打开的窗口、Remote 窗口、甚至下次启动都可能回退成英文。真正起效的只有两种情况:
- 通过
Configure Display Language命令设置后重启,该配置会写入locale.json并全局生效 - 手动创建的
locale.json文件被 VS Code 正确读取(路径、权限、JSON 格式三者全对)
最常被忽略的细节是:装完语言包后点了右下角按钮却没注意它只作用于当前窗口,结果新开一个窗口还是英文——这时候别怀疑插件,先检查 locale.json 是否真实存在且内容正确。











