scoop-extras.git安装加速

scoop-extras 安装加速完全指南

为什么 `scoop-extras` 装起来特别慢

Scoop 的软件清单按「bucket」（桶）组织，官方默认只有 `main`，大量常用工具（开发工具、编辑器、桌面软件）都放在 `extras` 桶里： powershell scoop bucket add extras 执行这条命令时，Scoop 实际做的是：

1. 从 GitHub 克隆 `https://github.com/ScoopInstaller/Extras` 这个清单仓库（几万个 JSON 文件，体积不小）；
2. 之后每次 `scoop install <软件>` 下载真正的安装包时，再访问软件的官方下载地址。

绝大多数情况下，慢的是第 1 步的 Git 克隆，以及第 2 步里指向 GitHub Releases 的下载。搞清这一点，加速就能对症下药。

---

方法一：给 Scoop 和 Git 配置代理

如果你本地有代理（例如 Clash 在 `127.0.0.1:7890`），分别给 Scoop 和 Git 设置即可。

Scoop 自身代理（影响下载阶段）： powershell scoop config proxy 127.0.0.1:7890 需要账号密码时写成 `用户名:密码@127.0.0.1:7890`。取消代理： powershell scoop config rm proxy Git 代理（影响 bucket 克隆阶段）： powershell git config --global http.proxy http://127.0.0.1:7890 git config --global https.proxy http://127.0.0.1:7890 取消： powershell git config --global --unset http.proxy git config --global --unset https.proxy 两步都做，才能同时覆盖「拉清单」和「下安装包」。

---

方法二：启用 aria2 多线程下载

Scoop 默认用 PowerShell 单线程下载，速度受限。启用 `aria2` 后可以多线程并发： powershell scoop install aria2 scoop config aria2-enabled true 可选调参（并发连接数与单服务器连接数）： powershell scoop config aria2-options "--split=16 --max-connection-per-server=16 --min-split-size=1M" 注意：`aria2` 对直连较快的源效果明显；如果访问 GitHub 本身不通，仍然要配合方法一的代理。

如果后续出现下载异常，可以先临时关闭排查： powershell scoop config aria2-enabled false ---

方法三：使用镜像 / 加速前缀

对 GitHub 访问受限的网络环境，常见思路是把清单仓库地址替换成可访问的加速地址。做法有两种：

临时替换克隆地址（手动克隆到 bucket 目录）： powershell

先看 bucket 位置

scoop config

手动克隆（这里 <加速前缀> 需替换为你实际可用、合规的加速服务地址）

git clone <加速前缀>https://github.com/ScoopInstaller/Extras.git "$env:USERPROFILE\scoop\buckets\extras" 要点：

• 目录名必须是 `extras`，路径要与 `scoop config` 里显示的 `root_path` 下 `buckets` 一致；
• 加速地址是否长期可用无法保证，选稳定的、合规的服务；
• 克隆完成后 `scoop bucket list` 应能看到 `extras`。

给 Git 配置全局 URL 重写（一次性配置，之后所有 GitHub 克隆都走加速）： powershell git config --global url."<加速前缀>https://github.com/".insteadOf "https://github.com/" 取消： powershell git config --global --unset url."<加速前缀>https://github.com/".insteadOf ---

方法四：只克隆需要的部分（浅克隆）

如果只是想让 `extras` 能用、不关心完整历史，可以用浅克隆重装： powershell scoop bucket rm extras git clone --depth 1 https://github.com/ScoopInstaller/Extras.git "$env:USERPROFILE\scoop\buckets\extras" `--depth 1` 只拉最新一次提交，能显著减少传输量。缺点是后续 `scoop update` 拉取清单历史时会略慢，但日常使用完全够用。

---

方法五：先装必要组件、再修复

有时慢是「边克隆边下组件」互相拖累。可以先单独装好下载器再补 bucket： powershell scoop install git scoop install aria2 scoop bucket add extras 若 `extras` 添加到一半失败，清理后重试： powershell scoop bucket rm extras scoop cache rm * scoop bucket add extras ---

常用命令与排查对照表