7个Supabase CLI实用技巧：从零开始构建全栈应用-开发者社区

7个Supabase CLI实用技巧：从零开始构建全栈应用

【免费下载链接】cliSupabase CLI项目地址: https://gitcode.com/gh_mirrors/cli23/cli

Supabase CLI是一个强大的开源命令行工具，它让开发者能够在本地环境中轻松管理Supabase项目的各个方面。无论是数据库迁移、云函数部署，还是类型生成，这个工具都能提供完整的工作流支持。在本文中，我们将通过7个核心技巧，帮助你快速掌握Supabase CLI的使用方法。

技巧一：快速搭建本地开发环境

使用Supabase CLI的第一步是配置本地开发环境。这个过程非常简单，只需要几个命令就能完成：

# 初始化新项目 npx supabase bootstrap # 启动本地服务 npx supabase start

启动成功后，你将获得一组关键的服务地址：

服务类型	默认地址	用途
API服务	http://localhost:54321	后端API接口
数据库	postgresql://postgres:postgres@localhost:54322/postgres	PostgreSQL数据库连接
Studio面板	http://localhost:54323	可视化数据库管理
邮件服务	http://localhost:54324	测试邮件发送功能

技巧二：高效管理数据库迁移

数据库迁移是Supabase CLI的核心功能之一。通过版本控制的方式管理数据库模式变更，可以确保团队协作的顺畅。

创建新迁移：

npx supabase db new create_users_table

编辑迁移文件：

-- supabase/migrations/20240101000000_create_users_table.sql CREATE TABLE IF NOT EXISTS users ( id UUID PRIMARY KEY DEFAULT gen_random_uuid(), email TEXT UNIQUE NOT NULL, created_at TIMESTAMPTZ DEFAULT NOW() ); -- 启用行级安全策略 ALTER TABLE users ENABLE ROW LEVEL SECURITY;

技巧三：云函数开发与部署

Supabase Edge Functions让你能够编写和部署无服务器函数。这些函数基于Deno运行，可以在全球边缘网络上提供服务。

创建新函数：

npx supabase functions new api-handler

本地测试函数：

npx supabase functions serve api-handler --no-verify-jwt

部署函数：

npx supabase functions deploy api-handler

技巧四：自动化类型生成

Supabase CLI可以从你的数据库模式自动生成TypeScript类型定义，这大大提升了开发效率和代码质量。

生成类型：

npx supabase gen types typescript --local > types/supabase.ts

在项目中使用：

import { createClient } from '@supabase/supabase-js' import { Database } from './types/supabase' const supabase = createClient<Database>( process.env.SUPABASE_URL!, process.env.SUPABASE_ANON_KEY! );

技巧五：团队协作最佳实践

在团队开发环境中，Supabase CLI提供了一套完整的协作工作流：

# 登录到Supabase账户 npx supabase login # 链接到远程项目 npx supabase link --project-ref your-project-ref

变更管理流程：

创建迁移文件
本地测试变更
提交代码到版本控制
部署到生产环境

技巧六：数据库分支管理

Supabase CLI支持创建数据库分支，这对于并行开发和功能测试非常有用。

创建和管理分支：

# 创建新分支 npx supabase branches create feature-auth # 切换分支 npx supabase branches activate feature-auth # 查看所有分支 npx supabase branches list

技巧七：监控与调试

Supabase CLI内置了丰富的监控和调试工具，帮助你及时发现和解决问题。

查看函数日志：

npx supabase functions logs api-handler --follow

数据库性能监控：

npx supabase inspect db-table-sizes

实用配置示例

下面是一个典型的Supabase项目结构：

my-project/ ├── supabase/ │ ├── config.toml │ ├── migrations/ │ │ └── 20240101000000_create_users.sql │ ├── functions/ │ │ └── api-handler/ │ │ ├── index.ts │ │ └── config.toml │ └── seed.sql ├── .env.local └── package.json