VSCode社区版(code-oss)不支持locale.json和Configure Display Language命令,因其构建时移除了Microsoft闭源语言加载器与NLS机制,即使手动创建locale.json或安装语言包也无效;唯一可行方案是改用VSCodium等预编译中文发行版,或从源码编译时注入zh-cn语言资源。

VSCode 社区版(即开源版本 code-oss)默认不带语言包,locale.json 配置无效——它压根不读这个文件,也不支持 Configure Display Language 命令。
为什么 community 版本不能用 locale.json
VSCode 社区版(code-oss)在构建时剥离了 Microsoft 闭源组件,包括语言包加载器和 locale 机制。即使你手动创建 locale.json 并写入 {"locale":"zh-cn"},启动后也不会触发任何翻译逻辑,界面始终英文。
- 社区版没有
ms-ceintl.vscode-language-pack-zh-hans插件的安装入口,扩展市场里搜不到官方中文语言包 -
Ctrl+Shift+P输入Configure Display Language—— 命令根本不存在,不会出现在列表中 - 所有基于
locale.json的路径(如%APPDATA%\Code\User\locale.json)对社区版无意义,文件存在与否不影响行为
社区版唯一可行的中文方案:换二进制或编译时注入
想让 code-oss 界面变中文,只有两个现实路径,都不依赖 locale.json:
- 用预编译的中文发行版(如 VSCodium + 中文语言包插件;注意:VSCodium 1.89+ 已支持部分语言包,但需手动下载
.vsix并code --install-extension xxx.vsix安装) - 自己从源码编译:克隆
code-oss仓库,在product.json中添加"nlsLanguages": { "zh-cn": "zh-cn" },再把对应vs/platform/locale/common/nls.zh-cn.js文件补全,否则编译会跳过中文资源 - 直接改用 VS Code 官方版(非社区版):它是唯一保证
locale.json+Configure Display Language全链路生效的版本
误操作常见报错与识别
如果你在社区版里强行创建 locale.json 或执行命令,会出现这些现象,说明方案走不通:
- 设置页搜索
locale,结果为空——locale字段根本不被识别 - 右下角状态栏永远显示
en,hover 提示、菜单、错误弹窗全是英文,且无任何提示说明“未启用本地化” - 终端运行
code --locale=zh-cn报错:Unknown option: --locale(社区版不支持该 CLI 参数) - 安装第三方“汉化插件”后,仅右键菜单或个别按钮变中文,命令面板/设置页/调试控制台仍为英文,且可能引发
Cannot read property 'translate' of undefined
社区版的定位就是“最小可用开源编辑器”,语言支持是明确舍弃的功能点。别在 locale.json 上浪费时间——要么换发行版,要么接受英文界面,这是当前(2026年9月)的硬限制。


















