必须安装Microsoft官方中文语言包并设置locale为"zh-cn",二者缺一不可;仅装插件不配置或配置错误(如写入settings.json、格式错误、未彻底重启)均导致设置页等仍显示英文。

VS Code 设置界面(即 Ctrl+, 打开的页面)不会自动汉化,必须同时满足两个硬性条件:装对语言包 + 正确设置 locale 为 "zh-cn";缺一不可,否则设置页、命令面板、错误提示等仍显示英文。
为什么装了中文插件,设置界面还是英文?
常见错误是只安装了插件但没启用——Chinese (Simplified) Language Pack for Visual Studio Code 只提供翻译资源,不自动激活。VS Code 启动时只读取 locale.json 中的 "locale" 字段来决定用哪套翻译,它默认是 "en"。
- 插件装错:搜“中文”“汉化”点进非 Microsoft 签名的扩展(如
Chinese Language Pack),会导致设置页部分字段乱码或不翻译 - 配置写错位置:把
"locale": "zh-cn"加到settings.json里完全无效,VS Code 忽略该字段 - 值写错格式:
"zh_CN"、"zh-hans"、"Chinese"、zh-cn(漏引号)全都不生效,静默回退英文
Configure Display Language 命令必须手动执行
这是唯一可靠、且面向用户的切换入口。它会自动创建或修改正确的 locale.json 文件,避免路径和格式手误。
- 按
Ctrl+Shift+P打开命令面板 - 输入并选择
Configure Display Language - 在弹出的列表中**明确点击
zh-cn**(不是“简体中文”文字项,是代码标识符) - 弹窗提示“需要重启窗口”,必须点
Restart——Developer: Reload Window不重载语言环境,无效
locale.json 路径和内容必须严格匹配
VS Code 只读取用户级 locale.json,且只认纯 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"}(注意双引号、小写、短横线) - 如果该文件已存在且含其他字段,只保留
"locale"键值对,避免语法错误导致整个文件被忽略
最常被跳过的动作是彻底退出进程:改完配置后若后台还有 Code.exe(Windows)或 Electron(macOS)残留,新启动的窗口仍可能继承旧语言环境。右下角状态栏显示 en 就说明没生效,此时应手动杀掉所有相关进程再重开。


















