vscode设置中文界面失败的主因是未正确执行configure display language命令并点restart now;必须安装microsoft官方语言包,确保locale.json内容为{"locale":"zh-cn"}且utf-8无bom编码,settings.json中设locale无效。

VSCode 设置中文界面失败,90% 是因为装了错的插件、写了错的 locale 值,或者没点那个关键的 Restart Now。
安装必须用 Microsoft 官方语言包
第三方插件如 Chinese Menu、vscode-zh-hans-menu 只改右键菜单或部分设置项,不翻命令面板、错误提示、调试控制台。它们不是语言包,只是补丁。
- 按
Ctrl+Shift+X搜索Chinese (Simplified) Language Pack for Visual Studio Code - 发布者必须是
Microsoft,带蓝勾认证图标 - 安装后右下角弹窗出现,必须点
Restart Now—— 仅Reload Window不会重载语言上下文
locale.json 是唯一生效配置位置
settings.json 里写 "locale": "zh-cn" 完全无效,VS Code 根本不读这个字段。
- 正确路径(三选一):
Windows:%APPDATA%\Code\User\locale.json
macOS:$HOME/Library/Application Support/Code/User/locale.json
Linux:$HOME/.config/Code/User/locale.json - 文件内容只能是严格 JSON 单行:
{"locale":"zh-cn"}
(双引号、小写、短横线、无空格、无逗号、无 BOM) - 如果文件已存在且含其他字段,直接删光,只留这一行,否则整个文件被忽略
Configure Display Language 命令只认 zh-cn
按 Ctrl+Shift+P 输入 Configure Display Language 后,列表里必须手动滚动找到 zh-cn —— 搜索 zh-CN、Chinese、zh_CN 都不会匹配,且无任何报错提示。
- 输入法切换、终端、调试控制台默认不随 locale 变,这是正常行为,不是配置失败
- Vim 插件用户注意:
vim.useCtrlKeys设为true会劫持Esc,导致无法切回英文输入法;设为false+Developer: Reload Window才能同步退出插入模式与输入法切换 - 某些插件(如
Python、Remote - SSH)配置页仍显示英文,是因为它们未内置中文翻译资源,和 VS Code 本体无关
真正容易被忽略的是:locale.json 必须 UTF-8 无 BOM 编码,且路径中不能有中文字符或空格;哪怕只多一个空格或用了全角引号,VS Code 就会静默回退到英文。











