VSCode安装Python扩展报错Error while fetching extension. XHR failed怎么办

问题现象 #

首次安装使用VSCode，在客户端内安装Python扩展时弹出错误提示：

Error while fetching extension. XHR failed

报错参考截图：

修复步骤 #

按优先级从高到低尝试以下方案：

• 检查代理与防火墙设置
  XHR报错本质是网络请求失败，首先排查网络拦截问题：
  1. 如果你正在使用代理/VPN，打开VSCode设置，搜索Http: Proxy，填入你本地代理的实际地址（常见本地代理格式为http://127.0.0.1:端口号，端口号以你自己的代理配置为准），将Http: Proxy Support选项设置为on，保存后重启VSCode重试安装。
  2. 如果没有使用代理，临时关闭系统防火墙、第三方安全防护软件，排除本地网络拦截后重试。
• 切换扩展市场国内镜像
  国内直连VSCode官方扩展市场经常出现连接超时，可通过启动参数切换国内镜像源：
  右键VSCode桌面快捷方式，选择「属性」，在「目标」输入框的原有内容末尾加一个空格，追加以下参数：

  --extensionsGallery='{"serviceUrl":"https://marketplace.snapmaker.com/vscode/gallery","itemUrl":"https://marketplace.snapmaker.com/vscode/item"}'
  

  保存设置后，通过该快捷方式重启VSCode，再尝试安装扩展即可。Mac/Linux用户可在终端启动VSCode时追加上述参数，或写入配置文件永久生效。
• 刷新本地DNS缓存
  部分情况是本地DNS解析异常导致的连接失败：
  • Windows用户：以管理员身份打开命令提示符，执行ipconfig /flushdns
  • Mac用户：打开终端执行sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
  • Linux用户：根据自身发行版执行对应DNS刷新命令即可
    执行完成后重启VSCode重试。
• 离线安装扩展（兜底方案）
  如果以上方法都无效，可走离线安装流程：
  1. 先在VSCode内点击「帮助-关于」，确认当前VSCode的版本号
  2. 下载对应版本适配的Python扩展VSIX安装包到本地
  3. 打开VSCode扩展面板，点击面板右上角的三个点按钮，选择「从VSIX安装」，选中本地下载好的安装包等待安装完成即可。

内容的提问来源于stack exchange，提问作者DonnyDongoran