VSCode安装中文包卡在“Installing…”是网络请求挂起所致,非操作或插件问题;需改用vscode.cdn.azure.cn镜像源、彻底关闭进程后修改settings.json并重启,或手动下载.vsix后用code --install-extension命令安装,并执行Configure Display Language选zh-hans后重启。

VSCode安装中文包卡在“Installing…”不动?基本是网络请求挂起
不是你操作错了,也不是插件坏了——VSCode 默认直连 marketplace.visualstudio.com,而这个域名在国内常被 DNS 污染、TLS 握手失败或连接重置。你看到的“Installing…”状态,本质是客户端在等 .vsix 文件流下载完成,但请求早已 pending 或超时,UI 却不报错。
常见表现包括:
• 点击“Install”后按钮变灰,无后续反馈
• 右下角提示“Installing extension…”持续数分钟不变化
• 命令面板执行 Extensions: Install from VSIX 后静默无响应
改用 vscode.cdn.azure.cn 镜像源,一劳永逸
这是目前最稳定、更新及时的国内替代方案,无需代理,兼容 VS Code 1.75+ 所有版本,也不需要额外配置证书。
操作步骤:
• 彻底关闭 VS Code 全部进程(Windows 任务管理器 / macOS 活动监视器里确认没有 Code Helper 或 Code 进程残留)
• 编辑用户设置文件:
– Windows:%APPDATA%\Code\User\settings.json
– macOS:~/Library/Application Support/Code/User/settings.json
– Linux:~/.config/Code/User/settings.json
• 在 settings.json 中添加两行(注意逗号分隔,末尾必须带 /):
"extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/",<br>"extensions.gallery.cacheUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/publishers"
• 保存后彻底重启 VS Code,再进扩展页——首次加载稍慢,但后续安装成功率接近 100%
手动下载 + code --install-extension 命令行安装更可靠
图形界面安装容易静默失败,尤其含 native 二进制的扩展(如 Python、C++ 插件),而命令行会立刻输出具体错误,方便定位。
关键动作:
• 确保 code 命令已加入 PATH:按 Ctrl+Shift+P → 输入 Shell Command: Install 'code' command in PATH 启用
• 下载官方包:访问 MS-CEINTL.vscode-language-pack-zh-hans 页面 → 拉到底部点 Download Extension → 得到类似 MS-CEINTL.vscode-language-pack-zh-hans-1.90.2.vsix 的文件
• 用绝对路径执行安装:code --install-extension "/home/user/Downloads/MS-CEINTL.vscode-language-pack-zh-hans-1.90.2.vsix"
• 若报 not compatible with Code,说明 package.json 中的 engines.vscode 字段与你本地版本不匹配——解压 .vsix,修改该字段为你当前 code --version 输出的主版本号(如 1.90.2 → 改为 ^1.90.0),再重新打包为 ZIP 并改后缀为 .vsix
装完还是英文?别跳过 Configure Display Language
中文语言包只是“翻译素材库”,不会自动激活。真正控制界面语言的是 locale.json 配置,而修改它的唯一标准路径就是命令 Configure Display Language。
必须执行:
• Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)
• 输入并**完整选中**命令名:Configure Display Language(不是 “change language” 或模糊匹配项)
• 在弹出列表中明确选择 zh-hans(不是 zh-cn、zh 或 zh-TW)
• **必须点击提示框里的 Restart 按钮**——仅重载窗口(Developer: Reload Window)无效
• 重启后仍部分英文?检查 $HOME/.vscode/locale.json(macOS/Linux)或 %USERPROFILE%\AppData\Roaming\Code\User\locale.json(Windows)内容是否为严格合法的 {"locale":"zh-hans"},多一个空格或引号都会导致回退英文
最容易被忽略的点是:VS Code 的语言切换和插件启用是两套独立机制。即使禁用所有其他插件,只要没运行 Configure Display Language 并重启,中文就不会出现——这不是 Bug,是设计如此。











