# Scoop

**Repository Path**: jiepot/Scoop

## Basic Information

- **Project Name**: Scoop
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Unlicense
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-28
- **Last Updated**: 2026-07-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h1 align="center">Scoop</h1>

<!--<img src="scoop.png" alt="Scoop 永存！"/>-->
<p align="center">
    <a href="https://github.com/ScoopInstaller/Scoop#what-does-scoop-do">功能</a>
    |
    <a href="https://github.com/ScoopInstaller/Scoop#installation">安装</a>
    |
    <a href="https://github.com/ScoopInstaller/Scoop/wiki">文档</a>
</p>

---

<p align="center">
    <a href="https://github.com/ScoopInstaller/Scoop">
        <img src="https://img.shields.io/github/languages/code-size/ScoopInstaller/Scoop.svg" alt="代码大小" />
    </a>
    <a href="https://github.com/ScoopInstaller/Scoop">
        <img src="https://img.shields.io/github/repo-size/ScoopInstaller/Scoop.svg" alt="仓库大小" />
    </a>
    <a href="https://github.com/ScoopInstaller/Scoop/actions/workflows/ci.yml">
        <img src="https://github.com/ScoopInstaller/Scoop/actions/workflows/ci.yml/badge.svg" alt="Scoop 核心 CI 测试" />
    </a>
    <a href="https://discord.gg/s9yRQHt">
        <img src="https://img.shields.io/badge/chat-on%20discord-7289DA.svg" alt="Discord 聊天" />
    </a>
    <a href="https://gitter.im/lukesampson/scoop">
        <img src="https://badges.gitter.im/lukesampson/scoop.png" alt="Gitter 聊天" />
    </a>
    <a href="./LICENSE">
        <img src="https://img.shields.io/badge/license-UNLICENSE%20or%20MIT-blue" alt="许可证" />
    </a>
</p>

Scoop 是 Windows 的命令行安装器。

## Scoop 能做什么？

Scoop 通过命令行安装应用，最大限度地减少操作摩擦。它：

- 消除[用户账户控制](https://learn.microsoft.com/windows/security/application-security/application-control/user-account-control/)（UAC）弹窗提示。
- 隐藏向导式安装程序的图形用户界面（GUI）。
- 避免污染 `PATH` 环境变量。通常，随着不同应用的安装，该变量会变得杂乱。
- 避免安装和卸载应用带来的意外副作用。
- 自动解析并安装依赖。
- 执行所有必要步骤，使应用进入可用状态。

Scoop 对脚本非常友好。你可以通过可重复的设置，让环境变成你喜欢的模样。例如：

```console
scoop install sudo
sudo scoop install 7zip git openssh --global
scoop install aria2 curl grep sed less touch
scoop install python ruby go perl
```

如果你构建了希望他人使用的软件，Scoop 是安装程序（如 MSI 或 InnoSetup）之外的另一种选择。你只需将应用压缩为 `.zip` 文件，并提供一个描述如何安装它的 JSON 清单即可。

## 安装

在普通（非管理员）PowerShell 终端中运行以下命令来安装 Scoop：

```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
```

**注意**：第一条命令允许你的设备运行安装和管理脚本。这是必要的，因为 Windows 10 客户端设备默认限制执行任何 PowerShell 脚本。

Scoop 将安装到默认位置：

`C:\Users\<你的用户名>\scoop`

有关安装程序的完整文档（包括高级安装配置），请访问 [ScoopInstaller/Install](https://github.com/ScoopInstaller/Install)。如果你对安装有疑问，请在那里提交新问题。

## 使用 `aria2` 进行多连接下载

Scoop 可以利用 [`aria2`](https://github.com/aria2/aria2) 进行多连接下载。只需通过 Scoop 安装 `aria2`，之后所有下载都将使用它。

```console
scoop install aria2
```

默认情况下，启用 `aria2` 后运行 `scoop install` 或 `scoop update` 时，`scoop` 会显示警告。可通过运行 `scoop config aria2-warning-enabled false` 关闭此警告。

你可以通过 `scoop config` 命令调整以下 `aria2` 设置：

- aria2-enabled（默认值：true）
- aria2-warning-enabled（默认值：true）
- [aria2-retry-wait](https://aria2.github.io/manual/en/html/aria2c.html#cmdoption-retry-wait)（默认值：2）
- [aria2-split](https://aria2.github.io/manual/en/html/aria2c.html#cmdoption-s)（默认值：5）
- [aria2-max-connection-per-server](https://aria2.github.io/manual/en/html/aria2c.html#cmdoption-x)（默认值：5）
- [aria2-min-split-size](https://aria2.github.io/manual/en/html/aria2c.html#cmdoption-k)（默认值：5M）
- [aria2-options](https://aria2.github.io/manual/en/html/aria2c.html#options)（默认值：）

## GitHub 镜像加速

Scoop 支持通过 `github_proxy` 配置项为 GitHub 地址配置镜像加速前缀，适用于国内等网络受限环境。

设置镜像代理：

```console
scoop config github_proxy https://ghproxy.com/
```

设置后，Scoop 会在以下场景自动为 GitHub 地址（`github.com` 和 `raw.githubusercontent.com`）添加此前缀：

- **`scoop update`** — Scoop 自更新、Bucket 同步、应用更新下载
- **`scoop download`** — 应用下载
- **`scoop bucket add`** — 添加 Bucket（clone 时使用原始地址，后续 `scoop update` 同步时自动走代理）

取消镜像代理：

```console
scoop config rm github_proxy
```

## 灵感来源

- [Homebrew](https://brew.sh/)
- [Sub](https://signalvnoise.com/posts/3264-automating-with-convention-introducing-sub)

## Scoop 可以安装哪些类型的应用？

Scoop 最适合安装所谓的"便携式"应用。这些应用是压缩文件，解压后即可独立运行。这类应用不会产生副作用，如更改 Windows 注册表或将文件放置在应用目录之外。

Scoop 也支持安装程序文件及其卸载方法。同样，它可以处理单文件应用和 PowerShell 脚本，这些甚至不需要压缩。请参考 [runat](https://github.com/ScoopInstaller/Main/blob/master/bucket/runat.json) 包作为示例：它只是一个 GitHub Gist。

### 参与贡献

如果你想通过添加功能或修复 Bug 来改进 Scoop，请阅读我们的[贡献指南](https://github.com/ScoopInstaller/.github/blob/main/.github/CONTRIBUTING.md)。

### 支持本项目

如果你觉得 Scoop 有用，并希望支持本项目的持续开发和维护，可以通过以下方式捐赠：

- [PayPal](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=DM2SUH9EUXSKJ)（一次性捐赠）

## 已知应用 Bucket

以下 Bucket 已被 Scoop 收录：

- [main](https://github.com/ScoopInstaller/Main) — 默认 Bucket，包含流行的非 GUI 应用。
- [extras](https://github.com/ScoopInstaller/Extras) — 不符合 main Bucket [标准](https://github.com/ScoopInstaller/Scoop/wiki/Criteria-for-including-apps-in-the-main-bucket)的应用。
- [games](https://github.com/Calinou/scoop-games) — 开源和免费的视频游戏及游戏相关工具。
- [nerd-fonts](https://github.com/matthewjberger/scoop-nerd-fonts) — Nerd 字体。
- [nirsoft](https://github.com/ScoopInstaller/Nirsoft) — 来自 [Nirsoft](https://nirsoft.net) 的 250 多个应用的合集。
- [sysinternals](https://github.com/niheaven/scoop-sysinternals) — 来自 [Microsoft](https://learn.microsoft.com/sysinternals/) 的 Sysinternals 工具套件。
- [java](https://github.com/ScoopInstaller/Java) — Java 开发工具包（JDK）、Java 运行时环境（JRE）、Java 虚拟机调试工具及基于 Java 的运行时引擎的合集。
- [nonportable](https://github.com/ScoopInstaller/Nonportable) — 非便携式应用（可能触发 UAC 提示）。
- [php](https://github.com/ScoopInstaller/PHP) — 大多数 PHP 版本的安装程序。
- [versions](https://github.com/ScoopInstaller/Versions) — 其他 Bucket 中应用的替代版本。

`main` Bucket 默认安装。你可以通过以下命令使用更多 Bucket：

```console
scoop bucket add <名称>
```

例如，要添加 `extras` Bucket，请输入：

```console
scoop bucket add extras
```

之后你就可以从 `extras` Bucket 安装应用了。

## 其他应用 Bucket

托管在 GitHub 上的许多其他应用 Bucket 可以在 [ScoopSearch](https://scoop.sh/) 或通过[其他搜索引擎](https://rasa.github.io/scoop-directory/#other-search-engines)找到。