唯一可靠路径是安装microsoft官方中文语言包并执行configure display language命令严格选择zh-cn后彻底重启。需避免第三方插件、手动改settings.json或reload窗口,且必须杀净后台进程、确保locale.json路径格式准确。

Configure Display Language 命令选 zh-cn 并彻底重启,是唯一可靠路径。装完插件不执行这步,界面永远是英文;点“重载窗口”或手改 settings.json 里的 locale,2026 年已全部失效。
必须装 Microsoft 官方语言包,ID 是 ms-ceintl.vscode-language-pack-zh-hans
搜“中文插件”大概率装错——第三方名字相似的扩展(比如 Chinese Language Pack 或 VSCode Chinese)不维护、不更新,装了反而报 Cannot read property 'translate' of undefined 或菜单乱码。
- 按
Ctrl+Shift+X(Windows/Linux)或Cmd+Shift+X(macOS)打开扩展面板 - 搜索框里**粘贴完整名称**:
Chinese (Simplified) Language Pack for Visual Studio Code - 只认发布者是 Microsoft、带蓝勾认证标识、ID 为
ms-ceintl.vscode-language-pack-zh-hans的那一项 - 安装后右下角会弹
Restart Now提示,但此时界面仍是英文——正常,插件只是“备好字典”,还没启用
Configure Display Language 命令必须选 zh-cn,大小写和连字符不能错
这个命令才是真正的“开关”。它会自动生成合法路径下的 locale.json,并写入 {"locale":"zh-cn"}。输成 Configure Language、选 zh 或 zh-CN 都无效,且无任何错误提示,只会静默维持英文。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入
Configure Display Language,回车执行 - 从下拉列表中**严格选择
zh-cn**(小写、短横线、不能有空格或引号) - 弹出“是否重启窗口”时,必须点
Restart——Reload Window不会重新初始化语言环境
手动写 locale.json 是最稳兜底方式,路径和格式必须精确
当命令面板打不开、公司内网无法访问市场、或切换后仍英文,直接编辑配置文件绕过 UI 层。VS Code 只读取特定路径下的 locale.json,其他位置一概忽略。
- 先彻底退出 VS Code:Windows 查任务管理器杀掉所有
Code.exe进程;macOS 用活动监视器结束Electron;Linux 执行pkill -f "code" - 新建或编辑对应路径的
locale.json文件:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:$HOME/Library/Application Support/Code/User/locale.json
– Linux:$HOME/.config/Code/User/locale.json - 文件内容仅一行:
{"locale":"zh-cn"},保存为 UTF-8 无 BOM 编码,不能有多余空格或注释
验证是否真生效,只看这三处,别被终端或插件界面骗了
终端(Terminal)、调试控制台(Debug Console)、Git 输出、Copilot Chat 等区域显示英文,属于正常限制,不是汉化失败。VS Code 主体语言不控制这些子系统。
- 顶部菜单栏:检查
文件/编辑/视图是否为中文 - 命令面板:
Ctrl+Shift+P打开后,输入框上方是否显示请输入命令或搜索设置 - 设置界面:
Ctrl+,打开后,左侧导航栏用户/工作区/扩展是否为中文 - 右下角状态栏如果还显示
en,说明没彻底重启或配置未加载,直接点击它选zh-cn是最快补救方式
zh-cn 必须严格小写加短横线。这两点卡住 90% 的首次配置。











