搜“chinese”找不到官方中文包,因vscode 1.85+已移除其模糊匹配;必须严格输入全名“chinese (simplified) language pack for visual studio code”或id“ms-ceintl.vscode-language-pack-zh-hans”安装,并配置locale.json为{"locale":"zh-cn"}后彻底重启。

搜“Chinese”根本不会命中官方中文包
VSCode 1.85+ 版本已从 Marketplace 搜索索引中移除 Chinese (Simplified) Language Pack for Visual Studio Code 的模糊匹配能力。输入 Chinese、中文、zh-cn 都不会返回结果——这不是网络问题,是微软主动关闭了关键词联想。
唯一有效的搜索方式只有两种:
- 在扩展面板(
Ctrl+Shift+X)中**严格粘贴全名**:Chinese (Simplified) Language Pack for Visual Studio Code(括号、空格、大小写、标点全部一致) - 用命令面板(
Ctrl+Shift+P)执行Extensions: Install Extension,然后直接粘贴 ID:ms-ceintl.vscode-language-pack-zh-hans
搜出来一堆“汉化增强”“中文主题”的第三方插件,基本都不维护,图标模糊、描述含广告、更新停滞,装了不仅无效,还可能干扰语言切换逻辑。
换镜像源后仍卡在转圈?检查 URL 末尾斜杠
国内用户常用 https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/ 作为镜像源,但 VSCode 对 URL 格式极其敏感:少一个末尾 / 就会静默失败——界面卡住、无报错、不加载,只转圈。
必须同时配置两项且都带斜杠:
"extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/""extensions.gallery.cacheUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/"
改完配置后,**必须彻底退出所有 VS Code 进程**(Windows 查任务管理器中是否还有 Code.exe,macOS 用活动监视器杀掉所有 Electron 和 Code Helper),否则新配置完全不生效。
装完还是英文?locale.json 才是生效开关
语言包只是把翻译资源放进本地,VSCode 默认仍用英文界面。真正控制显示语言的是 locale 配置项,它不在 settings.json 里,而是在独立的 locale.json 文件中。
该文件路径因系统而异:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json
文件内容只允许一行合法 JSON:{"locale":"zh-cn"}(注意:必须小写、短横线、双引号包裹;zh_CN、zh-hans、ZH-CN 全部无效)
保存后,若只关闭窗口再打开,大概率仍为英文——因为后台残留进程仍在读旧缓存。必须确认所有 VS Code 相关进程已退出,再全新启动。
Configure Display Language 命令搜不到?说明插件根本没装成功
这个命令本质是修改 locale.json,但它依赖语言包已正确安装并被 VS Code 识别。如果命令面板(Ctrl+Shift+P)里搜不到 Configure Display Language,不是命令名记错,而是插件未就位。
此时不要反复重试命令,应直接验证:
- 打开扩展面板,确认已安装插件的发布者是
Microsoft,ID 是ms-ceintl.vscode-language-pack-zh-hans - 点击插件右下角「Details」,看 URL 是否含该 ID;或检查插件详情页是否显示「Enabled」而非「Disabled」
- 若插件状态异常,卸载后用 ID 方式重装(
Extensions: Install Extension→ 粘贴ms-ceintl.vscode-language-pack-zh-hans)
最常被忽略的细节是:插件安装和语言激活是两个完全解耦的动作,中间没有自动触发机制。装完不设 locale,等于买了字典却不翻开——它就在那儿,但你永远看不到中文。











