离线安装vscode中文包必须通过命令面板执行“extensions: install from vsix”,再运行“configure display language”设为zh-cn并彻底重启;双击或拖拽.vsix无效,因vscode 1.70+已禁用该机制,且locale.json手动配置需严格遵循路径与格式。

离线安装必须用 Extensions: Install from VSIX 命令
双击 .vsix 文件或拖进 VSCode 窗口,99% 无效——VSCode 自 1.70 版起已禁用该机制,不会注册扩展 ID,也不会加载语言资源。现象是:文件被复制到 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows),但扩展面板里搜 ms-ceintl.vscode-language-pack-zh-hans 不显示“已启用”,右下角仍显示 en。
- 正确路径:按
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 回车 → 选中下载好的vscode-language-pack-zh-hans-*.vsix文件 → 点Install - 务必确认 .vsix 来源可靠:发布者必须是
MS-CEINTL,扩展 ID 必须是ms-ceintl.vscode-language-pack-zh-hans - 版本需匹配:若 VSCode 是 1.95+,建议用对应 release 页最新版,旧版 .vsix 可能因签名或 API 变更被拒绝
装完不生效?关键在 Configure Display Language
安装 .vsix 只是把翻译字典放进去,VSCode 默认仍以英文启动。真正切换 UI 语言靠的是内置命令,不是“装完即用”。很多人卡在这一步:点了 Install 就以为结束了,结果菜单、设置页、命令面板全是英文。
- 必须再按
Ctrl+Shift+P→ 输入Configure Display Language→ 选zh-cn(小写、短横线、不能是zh-hans或zh_CN) - 弹出提示后点
Restart,不是Reload Window;后者只重载插件,不刷新语言资源 - 如果命令面板根本搜不到
Configure Display Language,说明语言包没注册成功,先卸载再重走一遍Install from VSIX
locale.json 手动配置只填 {"locale":"zh-cn"},别碰 settings.json
当命令面板打不开、UI 卡死或需批量部署时,可手动编辑 locale.json。这个文件是 VSCode 启动时读取语言配置的唯一入口,settings.json 里加 "locale": "zh-cn" 完全无效。
- 路径要对:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json
- Windows:
- 内容严格为一行 JSON:
{"locale":"zh-cn"},UTF-8 编码、无 BOM、无多余空格或逗号 - 改完保存后,必须彻底退出所有 VSCode 进程:Windows 杀光
Code.exe,macOS 杀掉所有Electron进程,否则新配置不加载
验证是否真生效,看三处 UI 是否全中文
别只看右下角状态栏或某个菜单项。真正生效的标准是顶部菜单栏、命令面板(Ctrl+Shift+P)和设置页面(Ctrl+,)全部变成中文。任一区域仍是英文,说明语言协商失败,大概率是 zh-cn 没设对,或后台残留进程干扰了初始化。
-
zh-hans在 1.95+ 版本中仅加载基础字符串,调试面板、终端、设置页仍为英文 - 第三方“汉化插件”哪怕名字再像,也绝不能用——它们不更新、覆盖
locale.json、导致命令面板空白 - 内网环境最易忽略的是进程残留:一次 Restart 不够,必须杀干净再启











