离线安装VSCode中文语言包必须用命令面板执行Extensions: Install from VSIX并手动运行Configure Display Language选zh-cn后重启,双击或拖拽.vsix无效;安装后需验证顶部菜单栏、命令面板提示、设置导航栏三处全中文才算生效。

离线安装必须用命令面板的 Install from VSIX
直接双击或拖拽 .vsix 文件进 VSCode 窗口,99% 无效——VSCode 自 1.70 起已禁用该方式,静默失败且无提示。局域网内无法访问 Marketplace 时,唯一可靠路径是:Ctrl+Shift+P → 输入 Extensions: Install from VSIX → 选中提前下载好的 vscode-language-pack-zh-hans-*.vsix(发布者必须为 MS-CEINTL)→ 点 Install。
常见错误现象包括:安装后右下角仍显示 en、设置页全英文、重启多次无变化。根本原因是 VSCode 没把语言包注册进扩展系统,只是把文件存进了 ~/.vscode/extensions/ 目录但未激活。
Configure Display Language 命令必须手动执行且选 zh-cn
装完 .vsix 不等于界面变中文。必须再执行一次 Ctrl+Shift+P → Configure Display Language → 明确选 zh-cn(小写、短横线、双引号包裹),然后点 Restart(不是 Reload Window)。
zh-hans 在部分版本(如 1.95+)会导致设置页、调试面板仍为英文;zh_CN、Chinese、zh 全部不识别。这个值决定 VSCode 内部语言协商是否命中官方语言包 ID ms-ceintl.vscode-language-pack-zh-hans 的后缀匹配逻辑。
- 若命令面板搜不到
Configure Display Language,说明插件未成功注册,重试安装步骤 - 若选完
zh-cn后没弹提示,检查后台进程是否残留:Windows 任务管理器杀光所有Code.exe,macOS 活动监视器杀掉Electron进程 - 不要手动改
settings.json加"locale": "zh-cn"—— 这个字段在那里不被识别
远程开发需在目标环境单独部署
局域网常搭配 SSH/WSL 远程开发。本地装了中文包,对远程窗口完全无效。必须在远程机器上重复两步:Install from VSIX + Configure Display Language。
操作路径:点击右下角状态栏的 SSH: xxx → Install 'Chinese (Simplified) Language Pack' in SSH: xxx → 安装完成后,同样要运行 Configure Display Language 并选 zh-cn → 重启远程窗口。
注意:远程环境可能没有图形界面,此时需确保 locale.json 手动写入正确路径:
Linux 远程:~/.vscode-server/data/Machine/locale.json
Windows 远程:%USERPROFILE%\AppData\Roaming\Code\User\locale.json
验证是否真生效只看三处核心区域
别被终端输出、Git 提示、右下角状态栏骗了——它们本就不走 VSCode 的 locale 配置。真正有效的判断依据只有三个:
- 顶部菜单栏:文件、编辑、视图、终端是否为中文
- 命令面板提示:
Ctrl+Shift+P打开后,输入框上方是否显示「请输入命令或搜索设置」 - 设置界面左侧导航栏:是否为「常规」「用户设置」「工作区设置」等中文标签
这三处全中文,才算汉化完成。其余区域显示英文,属于设计如此,不是配置错误。最容易被忽略的是:远程窗口的语言设置和本地完全独立,且必须各自重启进程,不能只 reload。


















