卡死主因是marketplace.visualstudio.com请求挂起或被拦截，须同步配置serviceurl与cacheurl为同域镜像地址（如vscode.cdn.azure.cn）、结尾带/、写入用户级settings.json，并彻底退出所有code及code helper进程后重启。
卡死不是插件问题，而是 VS Code 扩展系统在等一个根本收不到的响应——90% 以上情况是 marketplace.visualstudio.com 请求挂起或被拦截，必须改链路、清状态、绕校验。
extensions.gallery.serviceUrl 和 cacheUrl 必须成对配置且同域
只改 serviceUrl 不生效，VS Code 1.83+ 会直接忽略整个镜像配置。两个字段必须同时存在、域名完全一致、结尾带 /，否则仍走默认境外地址。
- 正确写法（以 vscode.cdn.azure.cn 为例）：
"extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/""extensions.gallery.cacheUrl": "https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/publishers" - 常见错误：漏写
cacheUrl、serviceUrl末尾多了一个//、两个 URL 域名不一致（比如混用vscode.cdn.azure.cn和marketplace.visualstudio.com.cn） - 配置必须写在用户级
settings.json（Windows：%APPDATA%\Code\User\settings.json；macOS：~/Library/Application Support/Code/User/settings.json；Linux：~/.config/Code/User/settings.json），工作区设置不生效
安装卡在 99% 是解压失败，不是下载没完
进度条走到 99% 后不动，说明 .vsix 已下载完成，但 VS Code 正在往 .extensions-tmp 目录写入解压内容时被阻塞——杀软拦截、权限不足、或残留进程占用该目录都会导致静默挂起。
- 先彻底退出 VS Code：Windows 查
Code.exe和Code Helper.exe；macOS 用活动监视器搜Code和Code Helper (Renderer)；Linux 运行ps aux | grep code - 删除临时目录：
Windows：%USERPROFILE%\.vscode\.extensions-tmp
macOS/Linux：~/.vscode/.extensions-tmp - 删完别急着开 VS Code——它可能复用损坏缓存；重启前可顺手清空
~/.vscode/extensionsCache/（如有）
code --install-extension 命令行安装更可靠
图形界面容易静默失败，尤其含 native 二进制的插件（如 Python、C++、PlatformIO）。命令行会立刻输出具体错误，比如签名不匹配、版本不兼容或路径不存在。
- 确保
code命令可用：Ctrl+Shift+P → 输入Shell Command: Install 'code' command in PATH启用 - 下载 .vsix 后用绝对路径执行：
Linux/macOS：code --install-extension /home/user/Downloads/ms-ceintl.vscode-language-pack-zh-hans-1.90.0.vsix
Windows：code --install-extension "C:\Users\name\Downloads\ms-ceintl.vscode-language-pack-zh-hans-1.90.0.vsix"（含空格必须加引号） - 命令行不继承
settings.json镜像配置，若仍超时，需临时设环境变量：VSCODE_EXTENSIONS_MSA_URL=https://vscode.cdn.azure.cn code --install-extension xxx
离线安装后“Unable to load extension”？是签名校验在作怪
哪怕你断网拖入 .vsix，VS Code 仍会先尝试联网校验签名。失败后才退到本地加载，但这个流程常被跳过或中断——结果就是安装成功却报错无法加载。
- 最稳做法：拔网线 / 关 Wi-Fi → 完全退出 VS Code → 启动 → 拖 .vsix → 安装
- 若仍失败，可在
settings.json中临时加："extensions.installVerification": false（验证完务必删掉） - 注意：
locale.json的值必须是"zh-hans"（短横线、全小写），填zh-CN或zh在 VS Code 1.85+ 中已无效
真正卡住的地方往往不在界面上——而是在你没看到的进程残留、临时目录锁死、或是那两个必须严格配对的 URL 字段里。改完配置不重启全部进程，等于没改；删了缓存不关干净 Code Helper，等于白删。
