vs code界面变中文必须执行configure display language命令并选择zh-cn后彻底重启,仅安装中文语言包无效;该命令是启用翻译资源的唯一入口,且1.80+版本已移除此命令,须手动编辑locale.json文件生效。

VS Code 本体语言切换必须走 Configure Display Language 命令
插件界面语言不是插件自己决定的,而是由 VS Code 本体的 locale 决定。哪怕你装了中文语言包,不执行这一步,界面照样是英文。很多人卡在这一步,以为装完插件就自动生效。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入并选择
Configure Display Language,别拼错、别漏空格 - 在下拉列表里**手动滚动找到
zh-cn**(小写、带短横线;zh-CN、Chinese、zh_cn全无效) - 选中后弹窗提示“需要重启窗口”,必须点 Restart,不能点 “Reload Window”
重启后右下角状态栏应显示 zh-cn——这是唯一可信指标。如果没出现,说明后台进程残留,需手动杀掉所有 Code 进程再重开。
插件汉化失败?不是设置问题,是插件本身没提供中文资源
VS Code 本体切到中文后,Python、GitLens、ESLint 等插件界面仍是英文,这属于正常现象。它们的 UI 字符串是否翻译,取决于插件作者是否维护了中文语言包,VS Code 不强制统一。
- 检查插件页面:点扩展图标 → 找到对应插件 → 查看“Contributions”或“Languages”标签页,确认是否声明支持
zh-cn - 常见已汉化插件:
Pylance、Volar、Remote - SSH;长期未更新的第三方插件大概率无中文 - 个别插件(如
Vim)会劫持Esc键导致输入法异常,可关掉vim.useCtrlKeys临时缓解
远程开发(WSL / Remote-SSH)要单独配 locale.json
你在本地切好了中文,但连接 WSL 或远程服务器后界面又变英文?那是因为远程端的 VS Code Server 没同步语言配置,它读的是自己目录下的 locale.json。
- 关闭所有远程连接窗口
- 在远程机器上定位路径:
~/.vscode-server/data/Machine/*/locale.json(*是随机哈希名) - 编辑该文件,内容只留一行:
{"locale":"zh-cn"},保存为 UTF-8 无 BOM - 重新连接,无需重启远程服务
这个文件不会被本地设置自动覆盖,每次更新 VS Code Server 版本后都可能被重置,得手动再配一次。
别碰 settings.json 里的 "locale" 字段
VS Code 1.70+ 已彻底弃用 "locale": "zh-cn" 这种写法。写进去也静默忽略,既不报错也不生效。网上很多教程还在教这个,已经过时。
- 真正起作用的只有两个路径:命令面板执行
Configure Display Language,或直接编辑locale.json文件 -
locale.json路径(Windows):%APPDATA%\Code\User\locale.json;macOS/Linux 类似,都在User/下 - 编辑前务必关死所有 VS Code 进程,否则写入可能被缓存覆盖
最常被忽略的其实是「彻底退出」——点 Restart 后任务管理器里还躺着几个 Code Helper,它们会继承旧 locale,一开就是英文。











