必须手动执行configure display language命令并严格选择zh-cn(小写、连字符)后彻底重启,vs code 1.70+已弃用settings.json的locale配置,仅该命令能自动生成正确路径下的locale.json文件。

ConfigureDisplayLanguage 命令必须手动选 zh-cn
VSCode 没有“一键切换中英文界面”的快捷键,所谓“快速切换”实际靠 ConfigureDisplayLanguage 命令触发。但这个命令在命令面板里搜出来后,下拉列表**不支持关键词匹配**——输入 “zh” 或 “cn” 都不会高亮或过滤,必须手动滚动找到 zh-cn(小写、连字符,不是 zh_CN 或 zh-CN)。选错就白重启。
-
zh-cn是唯一被识别的值;zh-CN看起来更规范,但 VSCode 会静默忽略 - 如果列表里压根没
zh-cn,说明中文语言包没装好,不是设置问题 - 执行后弹窗提示重启,此时必须彻底退出进程:Windows 要在任务管理器里杀掉所有
Code.exe,macOS 要在活动监视器里结束Code和Code Helper
Ctrl+Shift+P 是唯一可靠入口,F1 不一定管用
很多人习惯按 F1 呼出命令面板,但在某些系统或插件冲突下(比如 Vim 插件启用时),F1 可能被劫持或失效。最稳的方式永远是 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)。
- 不要依赖搜索框自动补全——输入
configure display language后回车,而不是等它联想出选项再点 - 如果按了
Ctrl+Shift+P没反应,先检查是否被输入法或全局快捷键拦截(尤其是 macOS 的 Spotlight 或 Windows 的输入法热键) - 终端、调试控制台、设置页里该命令仍可用,不受当前编辑器焦点影响
settings.json 里 locale 配置容易写错格式
手动改配置文件是绕过 UI 的备用方案,但 settings.json 里写错一个字符就会让汉化失效。
- 必须是
"locale": "zh-cn",前后不能有多余空格,引号必须是英文双引号 - 不能写成
"locale": "zh-cn",(末尾逗号在 JSON 里合法,但某些旧版 VSCode 会报解析错误) - 该配置项要放在顶层对象里,不能嵌套在
"editor"或"workbench"下 - 改完保存后必须重启,仅重载窗口(
Developer: Reload Window)不生效
Vim 插件用户按 Esc 不切输入法?不是插件问题,是 vim.useCtrlKeys
界面语言和输入法切换是两套机制,但 Vim 插件会干扰后者。典型现象:进插入模式打中文 → 按 Esc → 只退出 Vim 模式,输入法图标不动。
- 根本原因是
vim.useCtrlKeys默认为true,它劫持了Esc事件,系统收不到原始信号 - 解决方法:打开设置(
Ctrl+,),搜vim.useCtrlKeys,设为false,然后执行Developer: Reload Window - 如果必须保留
true(例如依赖Ctrl+i跳转),就得用im-select手动绑定命令,不能指望Esc自动触发
zh-cn 这三个字符的大小写和连字符、vim.useCtrlKeys 的布尔值、以及重启时有没有清掉后台进程——这些细节不显眼,但每一步错了都会让整个流程断在最后一步。











