必须装Microsoft官方简体中文语言包、执行Configure Display Language命令选zh-cn、彻底重启进程三者缺一不可。非官方插件无效,settings.json中locale字段已废弃,locale.json需严格JSON格式且无BOM。

装对插件、设准 locale、彻底重启进程,三者缺一不可。只装插件不设语言,或点了 Reload Window 就以为完事,界面必然还是英文。
必须装 Microsoft 官方 Chinese (Simplified) Language Pack
搜“中文”“chinese”容易点错第三方包——比如 Chinese Language Pack 或 VSCode Chinese,这些非官方插件不维护、翻译残缺、甚至悄悄改 locale.json 导致后续失效。
- 正确操作:按
Ctrl+Shift+X打开扩展面板,搜Chinese (Simplified) Language Pack for Visual Studio Code,认准发布者是 Microsoft,带蓝勾认证 - 安装后右下角会弹提示,必须点
Restart;没弹提示≠装成功,说明语言包根本没触发注册逻辑 - 装完可在扩展列表里确认状态:插件启用中(图标不灰),且版本号与微软官网一致(当前最新为 1.2026.8.x)
Configure Display Language 命令必须执行且选 zh-cn
语言包只是翻译资源库,locale 才是开关。VS Code 启动时根本不读 settings.json 里的 "locale": "zh-cn" —— 这个字段自 1.70 版起已被废弃,写进去等于白写。
- 按
Ctrl+Shift+P输入Configure Display Language,回车执行 - 从下拉列表中明确选择
zh-cn(注意:不是zh_CN、zh-hans、zh-CN,大小写和连字符必须严格匹配) - 选完会弹“需要重启窗口”,此时点击
Restart,不是Reload Window—— 后者不重建语言环境,无效
重启必须彻底,不能残留 Code.exe 或 Electron 进程
VS Code 的语言状态绑定在进程实例上。旧进程没杀干净,新窗口会继承英文环境,导致一切设置看似生效实则无效。
- Windows:任务管理器里检查是否有残留的
Code.exe,全部结束;别只关窗口,要右键任务栏图标选“退出” - macOS:Dock 右键 VS Code 图标选“退出”,或活动监视器里查
Electron进程并强制退出 - Linux:终端执行
pkill -f code确保无残留 - 重启后右下角状态栏应显示
zh-cn,而非en;若仍显示en,说明没真正切过去
手动编辑 locale.json 是兜底方案,但格式容错极低
当命令面板打不开、公司内网无法访问扩展市场、或 UI 层异常时,直接写配置文件最可靠。但路径和 JSON 格式错一个字符就失败。
- 文件路径必须准确:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
- Windows:
- 文件内容只能是严格合法 JSON,仅一行:
{"locale":"zh-cn"}(双引号、小写、短横线、无 BOM、无注释、无多余空格) - 不要用记事本保存(易加 BOM),推荐用 VS Code 自己新建并保存为 UTF-8 无 BOM 编码
最容易被忽略的是:语言包和 locale 设置是两件事,而进程是否彻底退出是第三件事。三个条件都满足,中文界面才真正落地;漏掉任何一个,你看到的都是假象。


















