【笔记】Windows 系统安装 Scoop 包管理工具

#工作记录

一、问题背景

在进行开源项目 Suna 部署过程中，执行设置向导时遭遇报错：❌ Supabase CLI is not installed. 

根据资料检索，需通过 Windows 包管理工具Scoop安装 Supabase CLI。

初始尝试以管理员身份运行 PowerShell 安装 Scoop，操作后出现异常报错，遂启动本次问题排查与解决流程。

 

二、问题分析

1. 报错现象

以管理员身份执行 Scoop 安装脚本时，系统提示：

Running the installer as administrator is disabled by default, see https://github.com/ScoopInstaller/Install#for-admin for details.
Abort.

表明 Scoop 默认禁止以管理员权限安装，强制使用管理员身份会导致安装中断。

2. 原因定位

• 权限策略限制：Scoop 设计初衷为普通用户环境下运行，避免因管理员权限引发系统文件污染或权限冲突。
• 环境路径冲突：管理员模式下的安装路径可能与普通用户环境不兼容，导致后续命令无法识别。

三、解决步骤

• 以普通用户身份重新安装 Scoop

操作步骤：

• 关闭所有管理员窗口：退出已打开的管理员权限 PowerShell。
• 启动普通用户 PowerShell：
  • 通过 Win + R 输入 powershell 直接打开（非管理员模式）。
• 运行安装脚本：

  iwr -useb get.scoop.sh | iex
  

  

• 验证安装：
  输入 scoop --version，返回类似 Current Scoop version: v0.5.2 即表示安装成功。

scoop --version

 

成功安装 Scoop

• 验证结果：
  运行 scoop --version 显示版本号 v0.5.2，且提示 Scoop was installed successfully!，表明 Scoop 已正确安装。

 

 

四、Scoop 简介

Scoop 是 Windows 系统的命令行包管理工具，类似 Linux 的apt/yum，支持通过命令快速安装、更新、卸载软件，无需手动下载安装包，适合开发者高效管理工具环境。

五、安装前提

• 系统要求：Windows 7+（推荐 Windows 10/11）、PowerShell 5.1+
• 权限：以普通用户身份安装（无需管理员权限，避免权限冲突）

六、安装步骤

1. 打开 PowerShell（普通用户模式）

• 方式 1：按 Win + R，输入 powershell，点击确定。
• 方式 2：在文件资源管理器地址栏输入 powershell 并回车。

2. 运行安装脚本

在 PowerShell 中复制粘贴以下命令并回车：

iwr -useb get.scoop.sh | iex

• 过程说明：
  • 脚本会自动下载 Scoop 核心文件，并安装到用户目录 C:\Users\你的用户名\scoop。
  • 首次安装需等待下载（约几秒到几十秒，取决于网络）。

3. 验证安装成功

安装完成后，输入以下命令查看版本：

scoop --version

预期输出：

Current Scoop version:
v0.5.2 (示例版本号，以实际为准)

若显示版本信息，说明安装成功！

七、常见问题与解决

问题 1：执行策略限制（报错 无法加载文件）

现象：

无法加载文件 C:\Users\XXX\Documents\WindowsPowerShell\profile.ps1，因为在此系统上禁止运行脚本。

解决：

1. 运行命令查看当前执行策略：

   Get-ExecutionPolicy -Scope CurrentUser
   

    
   • 若返回 Restricted，需修改策略：

     Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
     

   • 输入 Y 确认允许运行本地脚本。

2. 重新打开 PowerShell，再次运行安装脚本。

问题 2：网络下载失败（报错 HTTP 404 或超时）

原因：

• 网络限制或微软官方源访问不稳定。

解决：

使用国内镜像加速安装：

$env:SCOOP_REPO = 'https://gitee.com/Luozhijun/scoop-installer'
iwr -useb 'https://gitee.com/Luozhijun/scoop-installer/raw/master/bin/install.ps1' | iex

问题 3：scoop 命令无法识别

现象：

输入 scoop 提示 术语“scoop”未被识别为 cmdlet。

解决：

1. 手动添加环境变量：
   • 按 Win + Pause 打开系统属性 → 高级 → 环境变量。
   • 在 用户变量 的 Path 中，添加 %USERPROFILE%\scoop\bin（例如：C:\Users\你的用户名\scoop\bin）。
2. 重启 PowerShell 或命令提示符。

八、常用命令（安装后必备）

1. 添加软件仓库（Bucket）

Scoop 默认仓库（main）包含常用工具，还可添加第三方仓库：

# 添加官方额外仓库（含更多开发工具）
scoop bucket add extras

# 添加Supabase官方仓库（用于安装Supabase CLI）
scoop bucket add supabase https://github.com/supabase/scoop-bucket.git

2. 安装软件

# 示例：安装Node.js
scoop install nodejs

# 示例：安装Supabase CLI
scoop install supabase

3. 管理软件

scoop update # 更新所有已安装的软件
scoop uninstall nodejs # 卸载软件
scoop search python # 搜索软件

九、最佳实践

• 以普通用户身份操作：避免使用管理员权限，减少系统文件污染风险。
• 定期更新 Scoop：

  scoop update scoop # 更新Scoop自身
  

• 清理缓存：

  scoop cleanup # 删除旧版本安装包
  

通过以上步骤，即可在 Windows 系统中高效使用 Scoop 管理开发工具。后续如需安装其他工具（如 Docker、Python 等），直接使用scoop install命令即可，大幅提升操作效率！