Windows 包管理器 Scoop 安装配置

打开 PowerShell（推荐普通用户权限），按顺序逐条运行以下命令：

第 1 步：允许运行脚本（只需执行一次）

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

部分	含义	说明
Set-ExecutionPolicy​	设置执行策略	PowerShell 的安全策略设置命令
RemoteSigned​	策略级别	允许运行本地脚本和已签名的远程脚本
-Scope CurrentUser​	作用范围	仅对当前用户生效，不影响系统其他用户

第 2 步：安装 Scoop

Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
# 缩写
irm get.scoop.sh | iex
# irm = Invoke-RestMethod（下载脚本）
# iex = Invoke-Expression（执行脚本）

注意：如果你的 PowerShell 是以管理员身份运行的（窗口标题带"管理员"字样），上面的命令会报错。需要改用这个命令：

iex "& {$(irm get.scoop.sh)} -RunAsAdmin"
# 为什么需要这样做？
# 如果检测到当前正在以管理员身份运行 PowerShell，且没有通过 -RunAsAdmin参数明确告知，那么脚本会主动报错并拒绝安装。
# -RunAsAdmin 参数的意义：这个参数的作用就是向安装脚本表明：“我知道我在用管理员身份运行，我确认需要这样做”。

安装完成之后，可以查看输出版本

scoop --version

安装成功之后就可以通过下面的指令进行下载软件了，但是scoop默认的仓库源可能是海外的，基本下载超时，所以建议是先重新配置镜像源

注意：这里有个经典的 Scoop 死循环问题：

Scoop 在添加（或重新添加）bucket 时，可能需要系统已安装 Git。系统没有 Git，导致无法执行 scoop bucket add 命令，
因为你没有能使用的库,所以也不能通过 scoop install git
所以建议是先手动安装git配置好环境变量

[git下载地址](https://git-scm.com/install/windows)

下载安装好之后，主要看下是否默认配置好了环境变量，如果没有需要自行配置下

git安装好之后，建议是PowerShell命令窗口需要重新在打开一下，否则可能还会出现git不存在的问题

配置镜像仓库地址

#查看已经配置的仓库源 
scoop bucket list

# 移除对应镜像源
scoop bucket rm main

# 添加对应镜像源 -- 这个可以自行搜索配置
scoop bucket add main https://mirror.nju.edu.cn/git/scoop-main.git
scoop bucket add extras https://mirror.nju.edu.cn/git/scoop-extras.git
scoop bucket add dorado https://gitee.com/scoop-bucket/dorado.git

# 步骤5：更新仓库列表
scoop update

安装配置完成之后，就可以执行下面指令了:

Scoop 常见指令

1、软件包管理命令

命令	功能描述
scoop install <package>	安装指定的软件包
scoop update <package>	更新指定的软件包
scoop uninstall <package>	卸载指定的软件包
scoop search <package>	在所有软件桶中查找匹配的软件包
scoop list <可选是否查询>	列出当前用户已安装的所有软件包
scoop update --all	更新所有已安装的软件包
scoop info <package>	查看指定软件包的详细信息
scoop reset <软件名>	切换软件版本

2、Scoop自身管理命令

命令	功能描述
scoop update	更新Scoop核心程序本身

3、软件桶管理命令

命令	功能描述
scoop bucket list	列出当前配置的所有软件桶
scoop bucket add <bucket>	添加新的软件桶（仓库）
scoop bucket remove <bucket>	移除已添加的软件桶

4、清理与缓存管理命令

命令	功能描述
scoop cleanup *	清理所有软件包的旧版本（保留当前版本）
scoop cache rm <package>	清除指定软件包的下载缓存
scoop cache rm *	清除所有软件包的下载缓存
scoop cleanup * && scoop cache rm *	一键清理：同时清理旧版本和所有缓存
scoop cleanup --dry-run *	预览可清理的旧版本（不实际删除）
scoop cache list	查看当前缓存中的所有文件

极佳的隔离性与系统洁癖友好

安装位置

• 用户级安装：默认所有软件都安装在 C:\Users<你的用户名>\scoop目录下。

隔离安装：

• Scoop 将每个软件的不同版本安装在不同的独立目录中（例如 scoop\apps\python\3.8.10和 scoop\apps\python\3.9.5) 并且可以灵活的进行版本切换

自动处理依赖：

• 尝试安装 python时，Scoop 会自动先安装 7zip、dark等必要的解压/安装工具。这种声明式的依赖管理，解决了手动查找和安装运行库的麻烦。

扩展知识：aria2

如果发现下载效率还是比较低，容易超时，处理设置镜像仓库之外，还可以结合 aria2 多线程下载，提升下载效率

# 安装 aria2（如果尚未安装）
scoop install aria2  #如果通过 scoop install aria2 下载失败，可以手动下载安装，配置好环境变量
aria2c --version  #命令行查看aria2c版本，成功之后正常下面配置

# 1、启用 aria2 下载
scoop config aria2-enabled true

# 2、（可选但推荐）调整 Aria2 下载参数以提升速度和稳定性
scoop config aria2-split 16
scoop config aria2-max-connection-per-server 16
scoop config aria2-min-split-size 1M
scoop config aria2-retry-wait 5
scoop config aria2-max-tries 5

# 关键配置项说明：
"aria2-enabled": true：核心开关，必须设置为 true才能启用 Aria2。
"aria2-split": 16：每个文件下载时分割的块数。
"aria2-max-connection-per-server": 16：连接到每个服务器的最大线程数。
"aria2-min-split-size": "1M"：每个分割块的最小大小（1MB）。
"aria2-retry-wait": 2：重试等待时间（秒）。
"aria2-max-tries": 5：最大重试次数。

# 3、检查当前配置状态
scoop config aria2-enabled  #如果返回 true，则表示 Aria2 已启用。

# 4. 查看完整配置
scoop config

这些配置也可以手动在scoop的config.json文件配置

默认路劲一般在当前用户文件夹下：%USERPROFILE%.config\scoop\config.json