核心问题是locale.json未生成或内容错误,因VS Code 1.70+已弃用settings.json中的"locale"字段,离线安装仅提供翻译资源,必须确保用户级locale.json存在且内容严格为{"locale":"zh-cn"}。

离线安装中文语言包后界面仍是英文,核心问题不是插件没装上,而是 locale.json 没生成或内容错误
VS Code 1.70+ 版本已彻底弃用 settings.json 中的 "locale" 字段,离线安装插件(如 ms-ceintl.vscode-language-pack-zh-hans)只是把翻译资源放进了 .vscode/extensions/ 目录,但不会自动写入语言开关文件。界面是否汉化,只取决于 locale.json 是否存在、路径是否正确、内容是否为 {"locale":"zh-cn"}。
- 离线安装后右下角无语言提示 → 插件未被识别,检查扩展面板是否真显示“启用”状态,发布者是否为 Microsoft
- 插件显示已启用但菜单仍是英文 →
locale.json缺失或值错误,必须手动创建或修正 - 误在
settings.json里加了"locale": "zh-cn"→ 这行完全无效,删掉,否则可能干扰其他设置
手动创建 locale.json 的路径和内容必须严丝合缝
VS Code 只读取用户级路径下的 locale.json,且容错率极低:多一个空格、少一个引号、编码带 BOM、用了中文标点,都会静默失败并回退英文。
- Windows 路径:
%APPDATA%\Code\User\locale.json - macOS 路径:
$HOME/Library/Application Support/Code/User/locale.json - Linux 路径:
$HOME/.config/Code/User/locale.json - 文件内容只能是这一行(无换行、无注释、UTF-8 无 BOM):
{"locale":"zh-cn"} - 别用记事本直接保存——它默认加 BOM;推荐用 VS Code 自身、Notepad++ 或 VS Code 的「新建文件 → 保存为 UTF-8 无 BOM」
离线环境无法执行 Configure Display Language 命令怎么办
命令面板搜不到 Configure Display Language,通常是因为插件未完成初始化(尤其离线安装后首次启动),此时命令不可用,但你可以跳过命令,直接手动操作。
- 先确认插件已解压到正确位置:
.vscode/extensions/ms-ceintl.vscode-language-pack-zh-hans-*目录下有package.json和language-packs/zh-cn子目录 - 关闭所有 VS Code 进程(包括后台的
Code.exe/Electron) - 按上述路径创建或覆盖
locale.json,确保内容为{"locale":"zh-cn"} - 重新启动 VS Code,不依赖命令面板,直接验证顶部菜单栏、设置页左侧导航、命令面板提示文字是否变中文
远程开发(SSH/WSL)场景下离线安装仍显示英文
你在本地离线装好了,连接 Remote-SSH 或 WSL 后插件管理页又变英文——这不是本地配置问题,而是远程端根本没装语言包,locale.json 也只在本地生效。
- 先连上远程环境(确保 Remote 插件已启用)
- 在远程窗口中打开扩展面板(
Ctrl+Shift+X),搜索ms-ceintl.vscode-language-pack-zh-hans - 点击「Install in SSH: [host]」或「Install in Dev Container」,不是「Install in Local」
- 再手动在远程端对应路径下创建
locale.json(例如 Linux 远程端就是~/.config/Code/User/locale.json) - 执行
Developer: Reload Window即可生效(远程窗口 reload 比全重启更可靠)
真正卡住人的从来不是“怎么装”,而是手动建 locale.json 时多了一个空格、路径写错一级、或者忘了远程端也要单独配——这些地方没有报错,只有沉默的英文界面。











