最稳解法是删除settings.json中整个extensions.gallery配置块并彻底退出vscode进程；常见失败原因为url末尾缺斜杠、存在不可见字符或进程未完全终止，删整段重配比调试更快更可靠。
settings.json 里 extensions.gallery 配置被污染导致“无权访问”
登录账号后插件市场突然报“你的帐户无权访问扩展市场”，大概率是 settings.json 中手动加过的 extensions.gallery 块出了问题。它可能包含不可见空格、换行符、或 URL 末尾缺斜杠，VSCode 解析失败但不报具体错误，直接拒绝请求。
操作上最稳的解法就是删掉整段：
- 按
Ctrl+Shift+P→ 输入Preferences: Open Settings (JSON)打开用户配置文件 - 搜索
"extensions.gallery": {，找到从{开始到对应}结束的整个块（含 serviceUrl / cacheUrl / itemUrl） - 整段删除，保存文件
- 彻底退出 VSCode（Windows 右键任务栏选“退出”，macOS 用 Activity Monitor 杀掉所有
Code进程），再重启
别试图修 URL——哪怕只差一个 / 或多一个空格，VSCode 就会静默失效。删了重来比调试快得多。
手动设置 extensions.gallery.serviceUrl 指向国内镜像源
默认地址 https://marketplace.visualstudio.com/_apis/public/gallery 在国内直连极不稳定，DNS 污染、TLS 重置、出口限速都可能导致 XHR 失败。改镜像不是“优化”，而是刚需。
必须确保三点：
- URL 末尾带
/（例如"https://vscode.cdn.azure.cn/extensionGallery/extensionGallery/"），少这个斜杠会 404 - 改完后必须完全退出 VSCode 进程，仅 reload window 不生效
- 镜像源要能被你当前网络访问：浏览器打开
https://vscode.cdn.azure.cn/extensionGallery看是否返回 JSON 列表
备选镜像（如果 azure.cn 不通）：
"https://vscode-extensions.oss-cn-hangzhou.aliyuncs.com/extensionGallery/extensionGallery/"-
"https://open-vsx.org/vscode/gallery"（注意它不支持微软官方认证插件，如ms-python.python）
代理配置错配引发“XHR failed”但无提示
很多人开了 Clash/Surge 却没开「系统代理」，结果 VSCode 读到 http.proxy 的值（比如 "http://127.0.0.1:7890"），但本地没监听该端口，请求卡在 pending 状态，界面只显示“加载中…”。
排查路径很直接：
- 打开设置（
Ctrl+,），搜proxy，看 HTTP Proxy 字段是否有值 - 如果值是本地地址（
127.0.0.1或localhost），且你没运行对应代理工具，就清空它 - 更彻底：进
settings.json，删掉整行"http.proxy": "xxx"和配套的"http.proxyStrictSSL": false - 重启 VSCode 后再试
注意：https.proxy 字段 VSCode 实际不识别，填了也无效，纯属干扰项，一并删掉。
离线安装 .vsix 后插件不生效的隐藏条件
拖拽 .vsix 文件进 VSCode 界面，看着“已安装”但插件没反应？常见原因不是文件损坏，而是 VSCode 没走完校验流程。
必须用命令行安装才可靠：
- 终端执行：
code --install-extension /path/to/plugin.vsix（Windows 用反斜杠，路径带引号防空格） - 不要解压 .vsix：它是 ZIP 格式，但 VSCode 要求原生二进制包，解压后签名失效
- 检查依赖：比如装
ms-python.python，必须先装ms-toolsai.jupyter，否则启动时报错但不提示
装完后，打开命令面板运行 Developer: Reload Window，强制刷新扩展主机进程——很多“装了不显示”问题靠这一步解决。
