📝 本文更新于 2026年7月。由于 Gitee 镜像仓库由社区维护，地址和可用性可能随时间变化。

一、Scoop 是什么？

Scoop 是 Windows 平台上的命令行包管理器，类似于 Linux 下的 apt、yum 或 macOS 下的 Homebrew。它的核心理念是：

• ✅ 无 UAC 弹窗：应用安装在用户目录下，无需管理员权限
• ✅ 无 PATH 污染：所有程序通过 shim 统一管理，不会搞乱系统环境变量
• ✅ 依赖自动处理：安装软件时自动拉取所需依赖
• ✅ 干净卸载：不会在系统里留下一堆残留文件和注册表垃圾

然而，Scoop 的安装脚本、主程序仓库以及所有 Bucket（软件仓库）全部托管在 GitHub 上，而 GitHub 的 raw.githubusercontent.com 在中国大陆经常无法访问或速度极慢。这就意味着，不加任何配置直接安装 Scoop 几乎 100% 会失败。

二、前置环境准备

三、核心问题：Scoop 安装链路的三个"墙点"

安装 Scoop 并正常使用的过程中，有三个关键环节会受到网络影响：

我们的镜像配置方案需要逐一解决这三个问题。

四、方案一：使用 Scoop 国内镜像一键安装（推荐）

社区维护的国内镜像项目 ScoopInstaller-Config 提供了一键安装方案。

步骤 1：设置执行策略

以普通用户身份打开 PowerShell，执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

步骤 2：配置 Git 代理（ Git 访问 GitHub 困难）

# 如果你有 HTTP 代理
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

# 如果使用 socks5 代理
git config --global http.proxy socks5://127.0.0.1:7891
git config --global https.proxy socks5://127.0.0.1:7891

步骤 3：通过环境变量指定 Scoop 安装为国内镜像

# 关键：指定 Scoop 核心仓库的 Gitee 镜像
$env:SCOOP_REPO = 'https://gitee.com/scoop-installer/Scoop'

# 执行安装
iwr -useb get.scoop.sh | iex

说明：SCOOP_REPO 环境变量会告诉安装脚本从哪里克隆 Scoop 的核心仓库。设置这个变量后，安装脚本就会走 Gitee 镜像而不是 GitHub。

如果 get.scoop.sh 也访问不了，可以直接执行镜像站的安装脚本：

# 备选方案：从 Gitee 直接下载安装脚本
iwr -useb https://gitee.com/scoop-installer/Scoop/raw/master/install.ps1 | iex

步骤 4：验证安装

scoop --version

如果看到版本号输出，说明 Scoop 核心已经安装成功。

五、方案二：手动下载安装

本方案适用于无网络的环境，或者执行方案一之后需要改变环境变量的默认值

步骤 1：手动下载 Scoop 仓库

浏览器访问 Gitee 镜像：https://gitee.com/scoop-installer/Scoop ，点击「克隆/下载」→ 下载 ZIP。

步骤 2：解压并放置

将 ZIP 解压到 %USERPROFILE%\scoop\apps\scoop\current 目录（如果没有则手动创建完整路径）。

步骤 3：添加环境变量和Path

不一定非要用命令，可以手动设置

环境变量的本质是SCOOP=%USERPROFILE%\scoop。

$env:SCOOP = "$env:USERPROFILE\scoop"
[Environment]::SetEnvironmentVariable('SCOOP', $env:SCOOP, 'User')

Path的本质是 用户Path 中加入%SCOOP%\shims。

$path = [Environment]::GetEnvironmentVariable('PATH', 'User')
if ($path -notlike "*scoop\shims*") {
    [Environment]::SetEnvironmentVariable('PATH', "$env:SCOOP\shims;$path", 'User')
}

重启终端，执行 scoop --version 验证。

六、安装后镜像配置（关键步骤）

Scoop 安装成功后，默认的 main bucket 指向的是 GitHub。现在我们需要把所有仓库源全部切换到国内镜像。

6.1 查看当前 Bucket

scoop bucket list

你应该会看到：

main
  Source: https://github.com/ScoopInstaller/Main

6.2 核心命令：将默认 main bucket 切换为 Gitee 镜像

# 删除默认的 main bucket（它指向 GitHub）
scoop bucket rm main

# 用 Gitee 镜像重新添加 main bucket
scoop bucket add main https://gitee.com/scoop-installer/Main

6.3 添加其他常用 Bucket（全部使用镜像）

# extras bucket —— 包含大量常用 GUI 软件（VSCode、Google Chrome 等）
scoop bucket add extras https://gitee.com/scoop-installer/Extras

# versions bucket —— 包含软件的历史版本
scoop bucket add versions https://gitee.com/scoop-installer/Versions

# java bucket —— JDK 各版本
scoop bucket add java https://gitee.com/scoop-installer/Java

# nirsoft bucket —— NirSoft 出品的实用小工具集合
scoop bucket add nirsoft https://gitee.com/scoop-installer/Nirsoft

6.4 确认配置

scoop bucket list

正确输出应该类似：

main
  Source: https://gitee.com/scoop-installer/Main
extras
  Source: https://gitee.com/scoop-installer/Extras
versions
  Source: https://gitee.com/scoop-installer/Versions
java
  Source: https://gitee.com/scoop-installer/Java

七、Gitee 可用镜像仓库汇总

以下是社区维护的 Gitee Scoop Bucket 镜像仓库地址一览：

⚠️ 注意：Gitee 镜像可能存在更新延迟，如果发现某个软件版本落后官方较多，可以临时切回 GitHub 源：

scoop bucket rm main
scoop bucket add main https://github.com/ScoopInstaller/Main

八、配置 aria2 多线程下载加速

Scoop 支持使用 aria2 进行多线程下载，这在下载大型软件包时能显著提升速度。

8.1 安装 aria2

scoop install aria2

8.2 配置 aria2 参数

# 关闭烦人的 aria2 警告
scoop config aria2-warning-enabled false

# 每个服务器最大连接数（建议 8~16）
scoop config aria2-max-connection-per-server 8

# 文件分片数
scoop config aria2-split 8

# 最小分片大小
scoop config aria2-min-split-size 4M

8.3 验证配置

scoop config

输出应包含你刚才设置的所有 aria2 配置项。

💡 提示：某些网站不支持多线程下载，此时可以临时禁用 aria2：

scoop config aria2-enabled false

九、配置代理（可选）

如果你有科学上网工具，可以在 Scoop 中配置代理：

9.1 设置 HTTP 代理

# HTTP 代理
scoop config proxy 127.0.0.1:7890

# 带认证的代理
scoop config proxy username:[email protected]:7890

9.2 取消代理

scoop config rm proxy

9.3 查看当前代理设置

scoop config proxy

十、完整操作流程速查表

如果你不想看前面的详细解释，这里是从头到尾的完整命令清单：

# ──────────── 第一步：设置执行策略 ────────────
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# ──────────── 第二步：指定 Scoop 核心仓库镜像 ────────────
$env:SCOOP_REPO = 'https://gitee.com/scoop-installer/Scoop'

# ──────────── 第三步：安装 Scoop ────────────
iwr -useb get.scoop.sh | iex

# （如果上面失败，用这个备选）
# iwr -useb https://gitee.com/scoop-installer/Scoop/raw/master/install.ps1 | iex

# ──────────── 第四步：切换 main bucket 到国内镜像 ────────────
scoop bucket rm main
scoop bucket add main https://gitee.com/scoop-installer/Main

# ──────────── 第五步：添加常用 buckets（全部镜像） ────────────
scoop bucket add extras https://gitee.com/scoop-installer/Extras
scoop bucket add versions https://gitee.com/scoop-installer/Versions
scoop bucket add java https://gitee.com/scoop-installer/Java
scoop bucket add nirsoft https://gitee.com/scoop-installer/Nirsoft

# ──────────── 第六步：安装并配置 aria2 加速下载 ────────────
scoop install aria2
scoop config aria2-warning-enabled false
scoop config aria2-max-connection-per-server 8
scoop config aria2-split 8
scoop config aria2-min-split-size 4M

# ──────────── 第七步：验证一切就绪 ────────────
scoop --version
scoop bucket list
scoop config

# ──────────── 第八步：装个软件试试！ ────────────
scoop install 7zip git curl sudo

十一、安装验证——试试装几个软件

# 基础工具
scoop install 7zip git curl sudo

# 开发工具
scoop install python nodejs-lts vscode

# 日常软件（来自 extras bucket）
scoop install googlechrome potplayer notepadplusplus

如果以上命令能够顺利下载安装，说明你的 Scoop 镜像配置已经完全生效 🎉

十二、常见问题排查

Q1: 报错 “Raw.githubusercontent.com” 连接失败

原因：DNS 污染，这是国内最常见的问题。

解决方案：

1. 检查 $env:SCOOP_REPO 是否已设置为 Gitee 镜像
2. 检查所有 bucket 是否已切换为 Gitee 源
3. 个别软件 manifest 中硬编码了 raw.githubusercontent.com 地址，需要使用科学上网工具

Q2: scoop update 或 scoop bucket add 非常慢

原因：bucket 仓库仍然指向 GitHub。

解决方案：

# 检查所有 bucket 源
scoop bucket list

# 如果发现某个 bucket 指向 github.com，删除后用 Gitee 镜像重新添加
scoop bucket rm <bucket-name>
scoop bucket add <bucket-name> https://gitee.com/scoop-installer/<Bucket-Name>

Q3: aria2 下载时报错

原因：某些下载源不支持多线程。

解决方案：

# 临时禁用 aria2
scoop config aria2-enabled false

# 安装完成后重新启用
scoop config aria2-enabled true

Q4: Git 克隆 Bucket 时报 SSL 错误

git config --global http.sslVerify false

⚠️ 与科学上网工具有关，这只建议作为临时解决方案。

Q5: Gitee 镜像仓库不存在或 404

Gitee 镜像仓库的命名或地址可能发生变化。你可以：

1. 在 Gitee 上搜索 scoop-installer 组织，确认最新仓库地址
2. 临时切回 GitHub 源并使用代理：

scoop config proxy 127.0.0.1:7890
scoop bucket rm main
scoop bucket add main

十三、进阶：使用 scoop-search 加速搜索

默认的 scoop search 需要遍历所有 bucket 的 manifest，非常慢。推荐安装 scoop-search：

scoop install scoop-search

之后用 scoop-search <关键词> 替代 scoop search，速度提升 10 倍以上。

通过以上配置，Scoop 在国内网络环境下可以做到基本无感知使用。整套流程走下来大约 5 分钟，一劳永逸。