vscode中文语言包需手动配置并彻底重启才生效,安装不等于启用;configure display language命令未出现说明语言包未成功安装或被第三方插件干扰;locale.json或settings.json中设"locale":"zh-cn"并完全退出进程才能稳定中文界面。

VSCode 的中文语言包不会自动生效,必须手动触发配置并彻底重启——所谓“自动生效”是常见误解,根源在于混淆了「安装」和「启用」两个阶段。
为什么 Configure Display Language 命令搜不到
命令面板里输入 Configure Display Language 后无响应或列表为空,基本说明语言包根本没装成功。VS Code 只有在检测到官方语言包已启用时,才会注册这个命令。
- 检查已安装扩展:按
Ctrl+Shift+P→ 输入Extensions: Show Installed Extensions→ 确认ms-ceintl.vscode-language-pack-zh-hans在列表中且状态为 Enabled - 第三方插件(如 “VSCode Chinese”、“汉化补丁”)会干扰命令注册,务必卸载所有非 Microsoft 发布的中文相关扩展
- 网络受限导致安装中断时,扩展可能处于“半安装”状态,重启 VS Code 后重试安装更可靠
装完语言包后界面仍是英文的真正原因
语言包只是提供翻译资源,VS Code 默认仍以英文启动。切换语言靠的是 Configure Display Language 命令写入 locale.json,而该文件只有在完整进程重启后才被重新读取。
- 右下角弹出的 Restart Now 提示必须点 ——
Reload Window完全无效,它不重载 UI 语言资源 - Windows 用户需检查任务管理器中是否还有残留的
Code.exe进程;macOS 用户要确认Electron进程已退出,否则新窗口复用旧 locale 配置 -
locale.json文件内容必须严格为{"locale":"zh-cn"}(小写、短横线、无空格、无 BOM),任何偏差都会导致静默回退英文
想让中文设置“稳定不丢”,别只靠 locale.json
VS Code 更新后 locale.json 被覆盖是高频问题,尤其在后台自动更新场景下。此时依赖命令面板切换已不可靠,应改用更稳定的方案。
- 直接编辑用户
settings.json,加入这一行:"locale": "zh-cn" - VS Code 1.80+ 明确支持该字段,且优先级高于
locale.json,不会被更新覆盖 - 路径位置:
%APPDATA%\Code\User\settings.json(Windows)、~/Library/Application Support/Code/User/settings.json(macOS)、~/.config/Code/User/settings.json(Linux) - 注意:不要在工作区
settings.json里加,它只影响当前项目,不控制界面语言
最易被忽略的一点:语言包本身不负责“保持生效”,它只是一次性注入资源;真正维持中文界面的是配置项与进程生命周期的配合。哪怕设置了 "locale": "zh-cn",如果 VS Code 进程没彻底退出,新窗口仍可能沿用旧环境变量或缓存的 locale 状态。











