VSCode命令面板快捷键提示仍为英文,因命令标题本地化依赖各命令注册时的title/category字段,微软内置部分命令已汉化,但大量新功能、实验API及第三方扩展仍硬编码英文;需确认vscode.env.language返回"zh-cn"且重启生效。

命令面板里的快捷键提示为什么还是英文
因为 VSCode 官方语言包只翻译 UI 框架层(菜单、设置页、侧边栏标题等),而命令面板(Ctrl+Shift+P)、补全建议(Ctrl+Space)、F1 列表中显示的文本,取决于每个命令注册时提供的 title 和 category 字段是否做了本地化。微软内置的部分命令(如 workbench.action.terminal.toggleTerminal)有中文翻译,但大量新功能、实验性 API 或第三方扩展命令仍硬编码英文字符串,VSCode 不会自动翻译它们。
确认语言环境是否真正生效
别只看菜单是不是中文——快捷键提示是否变中文,和 vscode.env.language 的返回值强相关:
- 打开命令面板(
Ctrl+Shift+P),输入Developer: Toggle Developer Tools,切换到 Console 标签页 - 执行
vscode.env.language,必须返回"zh-cn"(注意是小写、带短横、无空格) - 如果返回
undefined或"en",说明语言配置根本没加载成功,后续所有操作都无效 - 检查是否误在
settings.json里写了已弃用的"locale": "zh-cn"——这不仅无效,还可能干扰真实配置
哪些地方能变中文,哪些不能靠配置解决
能改善的:
- GitLens、ESLint、Prettier 等主流扩展支持显式语言字段,例如在
settings.json中加"gitlens.language": "zh-cn"或"prettier.locale": "zh-cn" - VSCode 内置命令若已本地化(如
File: Save→ “文件:保存”),其快捷键旁的括号提示(如Ctrl+S)也会同步显示中文描述
不能靠配置解决的:
- Electron 渲染层限制:快捷键括号里的英文描述(如
(Ctrl+F9))即使命令名已汉化,括号内仍显示原始键位名,无法翻译 - 第三方命令未做本地化:比如某些调试器插件注册的
debug.startSession,若作者没提供zh-cn对应的title,就永远是英文 - Node.js / Python 等语言服务器返回的 API 文档(hover 提示)本质是源码 JSDoc,不是界面文本,改 locale 对它完全无效
最常被忽略的生效前提:重启方式不对
语言切换不是热更新,必须彻底退出所有 VSCode 进程再启动:
- Windows/macOS:右键任务栏/ Dock 图标 → “退出”,不要只是关窗口
- Linux:终端执行
killall code或pkill -f 'code --ms-enable-electron-run-as-node' - 哪怕看到右下角弹出“Restart Required”,点“Later”或直接关闭弹窗,都不会触发语言重载
- 如果之前用过
Configure Display Language命令但没点“Change Language and Restart”,那配置其实根本没写入locale.json
真正起作用的唯一配置文件是 locale.json(路径因系统而异),内容只能是严格格式的 {"locale":"zh-cn"} ——多一个空格、大小写错、写成 zh-CN 都会导致 fallback 回英文。


















