VSCode根本不支持官方繁体中文语言包,运行时仅识别zh-cn,zh-tw等未被硬编码,手动设置会导致启动失败或回退为en-us;所谓繁体扩展仅能局部覆盖文案,无法汉化核心UI。

VSCode根本不支持官方繁体中文语言包
VSCode 运行时只识别 zh-cn 作为合法的简体中文 locale,zh-tw、zh-hk 等繁体语言标识未被硬编码进 Electron 渲染层和 UI 资源加载逻辑中。执行 Configure Display Language 命令后下拉列表里不会出现这些选项;手动在 locale.json 中写入 {"locale":"zh-tw"} 会导致启动失败或静默回退为 en-us。
所谓“繁体中文扩展”实际只能局部覆盖文案
目前有两个常被提及的扩展,但都存在根本性限制:
-
ms-ceintl.vscode-language-pack-zh-hant(微软实验性发布):仅加载极少量字符串(如个别设置项标题),新版 VSCode(1.85+)已停止加载该包;即使强制启用,菜单栏、命令面板、调试控制台、错误提示等核心 UI 仍为英文或简体中文 -
vscode-chinese-lang-zh-tw(第三方):仅替换部分 JSON 配置模板、注释占位符中的用词(如把「参数」改成「參數」),不影响任何 UI 控件、语法高亮、报错信息或快捷键提示
离线安装这些扩展也解决不了语言 ID 不被识别的问题
即使你把 vscode-language-pack-zh-hant-*.vsix 或 vscode-chinese-lang-zh-tw-*.vsix 文件拷贝到内网机器,用 Extensions: Install from VSIX 安装成功,也不会触发 VSCode 主程序的语言协商流程——因为它们不提供 zh-tw 对应的完整资源束(vscode-nls bundle),也不注册有效 locale handler。
常见失败现象包括:
-
Configure Display Language命令搜不到、点开后无zh-tw选项 - 安装后右下角状态栏仍显示
en,设置页、终端、问题面板全英文 - 手动编辑
locale.json并重启,VSCode 启动卡在白屏或自动恢复为en-us
真正可行的繁体环境适配方式
放弃“界面汉化”幻想,转向可落地的本地化配置:
- 在
settings.json中设置字体优先调用繁体字形:"editor.fontFamily": "Microsoft JhengHei, 'PingFang TC', 'Noto Sans CJK TC'" - 用
eslint-plugin-chinese或自定义规则,在代码注释/文档字符串中强制使用繁体术语(如參數、函式) - 操作系统层面切换语言:Windows/macOS 将系统语言设为「繁体中文(台湾)」,部分弹窗、文件对话框会随之变为繁体
- 接受 VSCode 界面保持简体或英文,专注提升开发流:用
Ctrl+P快速打开文件、Ctrl+Shift+P调出命令面板、F9打断点——这些快捷键与语言无关,效率不打折扣
最关键的细节是:VSCode 的语言机制不是“翻译开关”,而是基于 BCP 47 标准的资源绑定协议;没被源码认可的 locale,再大的 .vsix 文件也进不了主进程的 i18n pipeline。


















