【笔记】Windows 系统安装 Supabase CLI 完整指南（基于 Scoop）

#工作记录

前言

在进行开源项目 Suna 部署过程中，执行设置向导时遭遇报错：❌ Supabase CLI is not installed. 根据官方文档指引，需通过 Windows 包管理工具Scoop安装 Supabase CLI。

 

安装步骤记录

步骤 1：确保 Scoop 已正确安装

• 检查 Scoop 版本：
  打开 PowerShell（普通用户模式），输入：

scoop --version

 

• 若显示版本号（如v0.5.2），说明已安装，跳过此步骤。
• 若未安装，先运行：

iwr -useb get.scoop.sh | iex

 

步骤 2：添加 Supabase 官方仓库（Bucket）

在 PowerShell 中输入：

scoop bucket add supabase https://github.com/supabase/scoop-bucket.git

 

• 输出示例：

Added supabase bucket successfully.

步骤 3：安装 Supabase CLI

运行安装命令：

scoop install supabase

 

• 过程说明：
  • Scoop 会自动从 GitHub 下载和安装最新版的7zip 和 CLI（约几分钟）。
  • 安装完成后显示：

'7zip' (24.09) was installed successfully!

supabase (2.31.1) was installed successfully!

步骤 4：验证 CLI 安装

输入以下命令检查版本：

supabase --version

 

预期输出：

supabase v2.23.4

• 若提示'supabase' 不是内部或外部命令：
  1. 重启 PowerShell 或命令提示符（环境变量需重新加载）。
  2. 手动添加路径：
     • 按 Win + Pause 打开系统属性 → 高级 → 环境变量。
     • 在 用户变量 的 Path 中，确保包含 %USERPROFILE%\scoop\bin（如C:\Users\你的用户名\scoop\bin）。

步骤 5：（可选）更新 CLI 至最新版本

若后续需要升级，运行：

scoop update supabase

 

常见问题排查

问题 1：安装时提示仓库不可访问（404 错误）

原因：网络限制或仓库 URL 错误。
解决：

# 手动添加仓库（确保URL正确）
scoop bucket add supabase https://github.com/supabase/scoop-bucket.git

问题 2：权限不足导致安装失败

现象：普通用户模式下提示写入权限不足。
解决：

• 以管理员身份打开 PowerShell（仅在必要时），运行：

  $env:SCOOP_INSTALL_SCOOP_ARGS = '--admin'
  iwr -useb get.scoop.sh | iex
  scoop install supabase
  

• 安装后切换回普通用户模式操作。

问题 3：CLI 命令无法执行

原因：环境变量未生效或安装路径错误。
解决：

• 确认 Scoop 安装路径为C:\Users\你的用户名\scoop（非系统目录）。
• 重新启动终端，或手动将scoop\bin路径添加到系统PATH。

成功标志与后续操作

• 成功标志：
  输入supabase --version返回版本号，且运行supabase init无报错。

supabase --version

supabase init

• 后续操作：
  回到 Suna 项目目录，重新运行设置向导：

python setup.py

当向导执行到数据库初始化步骤时，CLI 会自动完成表结构创建（supabase db push）。

效率提示

• 命令补全：安装后可运行supabase completion powershell | Out-String | Invoke-Expression启用 PowerShell 自动补全。
• 官方文档：如需更多 CLI 用法，参考Supabase CLI 官方文档。

至此，Supabase CLI 已成功安装，可无缝衔接 Suna 项目部署流程！

安装参考文档

Scoop安装：

【笔记】Windows 系统安装 Scoop 包管理工具-CSDN博客

 Supabase CLI安装官方文档：

Supabase CLI | Supabase Docs