VS Code 中文界面需同时满足三条件:安装微软官方中文语言包(ID ms-ceintl.vscode-language-pack-zh-hans)、执行 Configure Display Language 命令将 locale.json 中 "locale" 设为 "zh-cn"、彻底重启进程(非仅 Reload Window)。

VS Code 默认不显示中文界面,装完插件不等于自动切语言——必须同时满足三个条件:装对官方语言包、执行 Configure Display Language 命令选 zh-cn、彻底重启进程(不是“重新加载窗口”)。
认准唯一有效的中文语言包
搜“中文”“汉化”大概率装错。第三方插件名字相似但不维护,可能带广告、乱码甚至污染命令面板。
- 正确插件名是
Chinese (Simplified) Language Pack for Visual Studio Code - 发布者必须是 Microsoft,扩展 ID 是
ms-ceintl.vscode-language-pack-zh-hans - 按
Ctrl+Shift+X打开扩展面板,搜Chinese (Simplified)(注意大小写和空格) - 安装后右下角弹出
Restart Now提示——必须点它,Reload Window不触发语言切换
Configure Display Language 命令必须手动执行
语言包只是翻译资源,“用哪套翻译”由这个命令控制。它不会自动运行,也不会出现在设置搜索里。
- 按
Ctrl+Shift+P打开命令面板,输入完整命令名:Configure Display Language - 从列表中严格选择
zh-cn(小写、连字符;zh_CN、zh-hans、Chinese全无效) - 弹窗提示“需要重启窗口”,必须点
Restart,否则locale.json不会写入新值 - 如果命令搜不到,基本说明语言包没装成功,或装完没重启过任何窗口
手动编辑 locale.json 强制生效
当命令面板打不开、UI 卡死、或批量部署时,这是最稳的兜底方式。它的优先级高于 UI 设置,且不依赖插件状态。
- 关闭所有 VS Code 窗口(Windows 检查任务管理器是否有残留
Code.exe) - 定位并编辑
locale.json文件:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:~/Library/Application Support/Code/User/locale.json
– Linux:~/.config/Code/User/locale.json - 文件内容仅一行标准 JSON:
{"locale":"zh-cn"}(无 BOM、无多余空格或逗号) - 保存后彻底重启 VS Code,不要只“重新加载窗口”
终端、调试控制台、Git 日志这些地方显示英文不是汉化失败——它们不走 VS Code 的 locale 设置,而是取决于系统语言或运行时环境。盯住顶部菜单栏、左侧活动栏 hover 文字、设置里搜 locale 看值是否为 zh-cn,这三处全中文才算真正生效。


















