离线安装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(小写、短横线、不能写 zh_CN 或 Chinese),然后点 Restart(不是 Reload Window)。
- 若命令面板搜不到
Configure Display Language,说明插件未成功注册,重试安装步骤 - 若选完
zh-cn后没弹提示,检查后台进程是否残留:Windows 任务管理器杀光所有Code.exe,macOS 活动监视器杀掉Electron进程 - 不要手动改
settings.json加"locale": "zh-cn"—— 这个字段在那里不被识别
远程开发需在目标环境单独部署
本地装了中文包,对远程窗口完全无效。必须在远程机器上重复两步: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 配置。
真正有效的验证点只有三个:
- 顶部菜单栏(File / Edit / View 等)
- 命令面板提示(
Ctrl+Shift+P弹出框里的文字) - 设置导航栏(左侧 Settings、Extensions、Keyboard Shortcuts 等标签)
这三处全中文才算真正生效;其余地方即使显示英文,也不代表语言包没装好。


















