VSCode中文界面需先安装微软官方语言包ms-ceintl.vscode-language-pack-zh-hans,再执行Configure Display Language命令设locale为"zh-cn"并彻底重启;缺一不可,仅装插件或仅重载窗口无效。

VSCode 设置中文界面不是“装个汉化包就完事”,而是分两步:先确保语言资源存在,再显式指定 locale。缺任何一环,界面都会卡在英文。
确认已安装官方中文语言包 ms-ceintl.vscode-language-pack-zh-hans
VSCode 1.85+ 版本起,Chinese (Simplified) Language Pack for Visual Studio Code 扩展已被微软标记为 deprecated,但它的 ID ms-ceintl.vscode-language-pack-zh-hans 仍是唯一受支持的语言包标识。它可能已随安装包内置,也可能需手动启用:
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Developer: Show Running Extensions,检查列表中是否有vscode-language-pack-zh-hans且状态为 Activated - 若未出现,说明语言资源缺失:前往官网
code.visualstudio.com,点击右上角国旗图标切换为简体中文,下载带内建语言支持的安装包(非扩展市场安装) - 不要安装发布者非
Microsoft、ID 不是ms-ceintl.vscode-language-pack-zh-hans的任何“中文插件”——它们不参与 VSCode 的本地化加载流程,vscode.l10n.t()调用会直接 fallback 到英文
修改 locale.json 并彻底重启,不能只点 Reload Window
locale.json 是控制界面语言的唯一有效配置文件,路径为:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
用命令面板执行 Configure Display Language 会自动打开该文件。务必确保内容是:
{"locale": "zh-cn"}
注意以下关键点:
- 值必须是小写
zh-cn,不是zh_CN、zh-hans或Chinese;VSCode 内部使用精确字符串匹配,错一个字符就失效 - 保存后弹出提示时,必须点击 Restart(不是 Cancel,也不是 Reload Window)——因为语言资源在主进程启动时加载,仅重载窗口无法刷新 UI 层语言上下文
- 验证是否真重启:Windows 查任务管理器中所有
Code.exe进程是否已退出;macOS 在活动监视器中确认Electron进程已终止
远程开发(SSH/WSL)下中文不生效?本地和远程都要配
VSCode 的 locale 设置不跨环境传递。你在本地设了 zh-cn,不代表远程终端里打开的 VSCode Server 就有中文界面:
- 连接到 WSL 或 Remote-SSH 后,同样要执行
Configure Display Language,并确保远程环境的locale.json文件也设为"zh-cn" - 远程机器上还需确认系统 locale 支持中文:Linux 执行
locale -a | grep zh_CN,若无输出需运行sudo locale-gen zh_CN.UTF-8;macOS 检查系统偏好设置 → 语言与地区,把简体中文拖到顶部 - 某些 Linux 发行版通过终端启动
code .时,会继承 shell 的LANG环境变量(如en_US.UTF-8),覆盖 VSCode 配置。建议从桌面图标启动,或在终端中先执行export LANG=zh_CN.UTF-8再运行code .
最常被忽略的是:你以为改了配置、点了 Restart,但后台进程还在跑,新窗口只是复用了旧的本地化上下文。真正生效的唯一判据,是全新启动后菜单栏、设置页、命令面板(Ctrl+Shift+P)全部显示中文——少一个,就说明某处没到位。


















