必须用extensions: install from vsix命令安装,双击或拖拽.vsix无效;安装后须执行configure display language选zh-cn并重启,仅三处核心界面全中文才算生效。

必须用 Extensions: Install from VSIX 命令安装
双击或拖拽 .vsix 文件进 VSCode 窗口,99% 无效——VSCode 自 1.70 版起已禁用该机制,静默失败且无提示。多台电脑批量部署时,若沿用旧习惯,会全部卡在“看似装了但界面仍是英文”的状态。
正确路径只有一条:Ctrl+Shift+P → 输入 Extensions: Install from VSIX → 选中 vscode-language-pack-zh-hans-*.vsix(发布者必须为 MS-CEINTL)→ 点 Install。
- 提前验证文件来源:打开
.vsix(本质是 zip),检查内部package.json中的"engines": {"vscode": "^1.xxx.0"}是否匹配目标机上code --version输出的主版本号 - 不要用百度网盘链接、第三方封装包或“汉化补丁.exe”,它们常带过期语言资源或签名异常,尤其在银河麒麟、UOS 等国产系统上直接被沙箱拦截
- 每台机器都必须独立执行该命令——VSCode 不共享扩展注册状态,复制
.vsix文件过去不等于安装完成
Configure Display Language 必须手动选 zh-cn
装完 .vsix ≠ 界面变中文。90% 的“失效”发生在第二步:没运行 Configure Display Language 或选错了值。
Ctrl+Shift+P → 输入并执行 Configure Display Language → 明确选 zh-cn(小写、连字符、无空格、不带引号)→ 点 Restart(不是 Reload Window)。
-
zh-hans在 VSCode 1.95+ 版本中仅加载部分 UI 字符串,设置页、调试面板、终端标题栏仍为英文 -
zh_CN、ZH-CN、Chinese全部不识别,VSCode 直接忽略该配置 - 如果命令面板搜不到
Configure Display Language,说明语言包根本没注册成功,需先卸载再重走 Install from VSIX 流程
远程开发环境要单独部署
本地装了中文包,对 SSH / WSL / 容器等远程窗口完全无效。VSCode 的语言包是按运行环境隔离的,远程窗口启动的是另一套 Electron 实例。
操作路径:Ctrl+Shift+P → 输入 Remote-SSH: Install 'Chinese (Simplified) Language Pack' in SSH: xxx → 安装完成后,同样执行 Configure Display Language 并选 zh-cn → 重启远程窗口。
- 若远程机器无图形界面(如纯 Linux 服务器),需手动创建
locale.json:
Linux 路径:~/.vscode-server/data/Machine/locale.json
Windows 远程:%USERPROFILE%\AppData\Roaming\Code\User\locale.json - 文件内容严格为:
{"locale":"zh-cn"}(UTF-8 无 BOM 编码,不能有多余逗号或换行) - 别改
settings.json里的"locale"字段——这个字段在当前版本中不被识别
验证是否真生效只看三处核心区域
别被右下角状态栏、终端输出、Git 提示骗了——它们不走 VSCode 的 locale 配置逻辑。真正决定“是否汉化成功”的只有三个地方:
- 顶部菜单栏(File / Edit / View…)是否为中文
- 命令面板(
Ctrl+Shift+P)里的提示文字是否为中文 - 设置页面(
Ctrl+,)左侧导航栏和右侧搜索框是否为中文
只要这三处全中文,才算真正生效;其余区域(比如调试控制台、问题面板标题)延迟刷新或个别未翻译属正常现象。最容易被忽略的是后台残留进程:Windows 上要杀光所有 Code.exe,macOS/Linux 上需 pkill -f "Electron",否则新配置根本不会加载。











