离线安装后configure display language命令搜不到,说明语言包未成功注册,需先确认扩展面板中microsoft官方包(id: ms-ceintl.vscode-language-pack-zh-hans)已启用;若未出现,应彻底退出vscode进程(windows杀code.exe,macos杀code helper),再重启并重试install from vsix;若仍无效,则手动创建utf-8无bom的locale.json文件,内容为{"locale":"zh-cn"},路径为%appdata%\code\locale.json(win)或$home/library/application support/code/locale.json(macos)。

离线安装后 Configure Display Language 命令搜不到怎么办
离线安装 vscode-language-pack-zh-hans.vsix 成功后,Configure Display Language 命令仍不出现,大概率是语言包没真正加载——VSCode 启动时未识别到已安装的本地包,命令面板自然不会注册该功能。
此时不能依赖“搜一下就出来”,得手动触发语言配置入口:
- 先确认安装是否成功:打开扩展面板(
Ctrl+Shift+X),搜索Chinese (Simplified),看是否有状态为“已启用”且发布者是Microsoft的条目 - 若扩展列表里有但命令面板搜不到,执行
Ctrl+Shift+P→ 输入Developer: Reload Window强制重载一次 UI(注意:这只是临时补救,不是最终生效步骤) - 若仍无反应,说明语言资源未注入,需跳过命令面板,直接编辑
locale.json
手动打开 locale.json 文件的两种可靠方式
当快捷键失效或命令不可见时,locale.json 是最底层、最稳定的语言开关。它不在用户界面里,但在文件系统中明确存在,且优先级高于所有图形操作。
推荐两种打开路径:
- 用快捷键组合:按
Ctrl+Shift+P→ 输入Preferences: Configure Language Specific Settings→ 回车 → 在弹出的“Select Language”框里随便选一个(比如json)→ 此时 VSCode 会自动打开一个空的settings.json;这时你手动把路径改成%APPDATA%\Code\locale.json(Windows)或$HOME/Library/Application Support/Code/locale.json(macOS)并回车,即可强制打开 - 更直接的方式:直接在文件管理器中导航到对应路径,新建或编辑
locale.json,内容仅写一行:{"locale":"zh-cn"},保存(必须 UTF-8 编码,无 BOM)
为什么 Reload Window 不让 Configure Display Language 出现
Reload Window 只重载插件和 UI 组件,但语言包的初始化发生在主进程启动阶段。离线安装的 .vsix 包需要完整重启才能被 Electron 主进程扫描并注册内置命令。
常见误操作包括:
- 执行
code --install-extension xxx.vsix后只点了 Reload,没退出 VSCode 进程 - Windows 下残留了后台
Code.exe进程,新窗口实际复用了旧进程上下文 - macOS 上
Code Helper进程未终止,导致 locale 配置缓存未刷新
验证是否彻底退出:Windows 打开任务管理器,结束所有 Code.exe;macOS 运行 killall -u $USER 'Code Helper' 再启动。
locale.json 写错格式的典型报错现象
即使离线安装成功、也重启了,如果 locale.json 内容不对,界面仍不会变中文,且没有任何提示。
必须严格满足以下三点:
- 文件名必须是
locale.json(不是language.json、locales.json或带版本号的变体) - 内容只能是标准 JSON 对象,且仅含
locale字段:{"locale":"zh-cn"}(注意双引号、小写、连字符,zh_CN或ZH-CN均无效) - 文件编码必须为 UTF-8 无 BOM;用记事本另存时容易带 BOM,建议用 VSCode 自身或 Notepad++ 保存
写错后最隐蔽的表现是:菜单栏、设置页仍是英文,但右下角状态栏突然消失——这是 locale 加载失败导致部分 UI 组件降级渲染的结果。











