2026-08-31 · 学习笔记 02

Scoop 常用命令

1. 搜索

不知道软件在不在，先搜：

scoop search jdk
# 输出所有 bucket 中包含 jdk 的软件名

2. 安装

scoop install <软件名>
# 例：scoop install 7zip

一次装多个：

scoop install git maven nodejs-lts

想装但不确定名字，先 scoop search，再用 scoop info <软件名> 看描述、版本、依赖：

scoop info mysql

3. 查看已装的

scoop list            # 全部已装软件
scoop list | wc -l    # 数量

4. 更新

scoop status                # 查哪些有新版本（会拉取所有 bucket，走的代理见配置篇）
scoop update                # 更新 scoop 本体
scoop update <软件名>        # 更新指定软件
scoop update *              # 更新全部软件

scoop update * 输出一屏软件逐个下载，耐心等完即可。中断了也没关系，重跑会接着完成。

5. 卸载

scoop uninstall <软件名>

只删程序目录。persist 里的数据目录保留（比如 MySQL 数据），确定不要再手动删 scoop\persist\<软件名>\。

6. 清理

scoop cleanup *              # 删除所有软件的旧版本（必须带 *，或 -a/--all）
scoop cache rm <软件名>       # 删某个软件的下载缓存
scoop cache rm *             # 清空全部缓存

scoop cleanup 裸跑会报 ERROR: <app> missing，要么指定软件名，要么 * 清全部。只删旧版本，current 指向的当前版本不动。

7. 桶（bucket）管理

bucket 是软件清单仓库，默认只有 main。常用官方桶：

scoop bucket list                            # 已添加的桶
scoop bucket add extras                      # 扩展桶（浏览器、日常软件等）
scoop bucket add java                        # JDK 桶（temurin-jdk25 等）
scoop bucket rm <名字>                        # 移除桶

装非 main 桶的软件前先 add 对应桶，例如：

scoop bucket add java
scoop install temurin25-jdk

8. 常见问题

现象	处理
scoop status 报 schannel: failed to receive handshake	代理链路 TLS 握手不稳，重跑一次；反复出现先按配置篇排查代理是否假死
下载报 连接尝试失败 <IP>:443	系统代理没开或节点不通，开代理客户端的「系统代理」开关再重试
提示需要管理员权限	scoop 默认装用户目录无需管理员；-g 全局模式才需要
命令找不到（scoop 不存在）	重新安装，见安装篇

9. 环境速记

项目	值
scoop 目录	C:\Users\<你>\scoop\
已装桶（本机）	main / extras / java
代理	客户端「系统代理」开关，scoop/git 零配置自动生效

7zip 不用手动装——它是 scoop 的内置 helper，首次需要解压安装包时自动安装（innounp、lessmsi 同理）。

常用软件装机一遍到位：

scoop bucket add java
scoop install git maven python temurin25-jdk bun uv nodejs-lts mysql redis claude-code codex

（temurin25-jdk 在 java 桶，先 add 再装；其余都在 main 桶。）