vscode汉化包卡在“正在安装”是因请求境外域名marketplace.visualstudio.com和vscode.blob.core.windows.net失败;需在用户settings.json中完整配置serviceurl与cacheurl(同域且结尾无/),并彻底退出进程后重启,命令行安装还需设置vscode_extensions_msa_url环境变量,装完须通过命令面板手动切换显示语言为zh-cn。

为什么汉化包总卡在“正在安装”
VSCode 汉化插件(如 Chinese (Simplified) Language Pack for Visual Studio Code)下载失败,根本不是插件本身问题,而是请求发往了 marketplace.visualstudio.com 和 vscode.blob.core.windows.net 这两个境外域名。国内直连时,DNS 解析常失败、TLS 握手超时、CDN 节点响应慢或被限速,导致请求状态长期为 pending,界面就一直转圈。
settings.json 必须配全这两项
只改 extensions.gallery.serviceUrl 不够,cacheUrl 缺一不可——VSCode 1.83+ 版本会忽略未配 cacheUrl 的配置,即使 serviceUrl 正确也无效。
-
"extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/_apis/public/gallery"—— 微软中国 CDN,延迟低,但部分新插件同步略滞后 -
"extensions.gallery.cacheUrl": "https://vscode.cdn.azure.cn/_apis/public/gallery/publishers"—— 必须与 serviceUrl 同域,且结尾不能带/ - 配置必须加在用户 settings.json 里(路径:
%APPDATA%\Code\User\settings.json或~/.config/Code/User/settings.json),不是工作区设置 - 改完保存后,务必彻底退出 VSCode 进程(Windows 右键任务栏 →「退出」;macOS 用 Activity Monitor 杀掉所有
Code进程),再重启
命令行安装汉化包仍失败?检查环境变量
用 code --install-extension ms-ceintl.vscode-language-pack-zh-hans 失败,大概率是终端没继承镜像配置。VSCode 命令行工具不读 settings.json,得靠环境变量驱动:
- 临时生效:运行前先设
VSCODE_EXTENSIONS_MSA_URL=https://vscode.cdn.azure.cn - Linux/macOS:在终端执行
export VSCODE_EXTENSIONS_MSA_URL=https://vscode.cdn.azure.cn,再运行code --install-extension - Windows PowerShell:用
$env:VSCODE_EXTENSIONS_MSA_URL="https://vscode.cdn.azure.cn" - 如果还报
connect ETIMEDOUT,说明本地开了 Clash/Surge 的 TUN 模式——它会劫持 socket,让 HTTPS 请求无声失败,此时需临时关闭代理
汉化包装上了但语言没变?别漏这一步
装完语言包只是第一步,VSCode 默认仍用英文界面。必须手动切换 UI 语言:
- 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入并选择
Configure Display Language - 在弹出列表中选
zh-cn,确认后重启 VSCode - 注意:某些 Remote 开发场景(SSH/WSL)下,语言包需装在远程机器上,且远程 VSCode Server 也要配对应镜像源,本地 settings.json 无效
镜像源配置看似简单,但 serviceUrl 和 cacheUrl 的路径细节、进程是否彻底重启、命令行是否设环境变量,三者任一遗漏都会让汉化包卡住不动——不是网络差,是配置没真正跑起来。











