firebase

firebase 快速入门

Google 系的 BaaS 标杆,一套 SDK 覆盖 Auth、数据库、云函数、托管、移动分析。

这是什么?解决什么问题?

如果你正在做移动 App(尤其 Android/iOS)或实时 Web 应用,Firebase 几乎是绕不开的选项。它把”用户系统 + NoSQL 数据库 + 云函数 + 静态托管 + 推送 + 远程配置 + 崩溃监控”打包成一套 SDK,Google 内部也在大量使用。
firebase Skill 是 Firebase 官方维护的 Agent Skill(MCP Server),核心是把 Firebase 全家桶(Authentication、Cloud Firestore、Realtime Database、Cloud Functions for Firebase、Hosting、Cloud Storage、Cloud Messaging、Remote Config)的能力暴露成 AI 可调用的工具集。
加载 Skill 后,AI 不只是”查文档”,而是能直接帮你在 Firebase 项目里:建 Firestore 集合、配置 Auth 登录方式、部署 Cloud Function、查 Hosting 部署历史、读 Crashlytics 报告。Skill 内部封装了”什么时候该用 Firestore、什么时候该用 Realtime DB”、“Cloud Function 冷启动优化”、“Firestore 安全规则写法”等最佳实践。
适合:移动 App 开发者、做实时协作的 Web 团队、需要快速搭建后端的独立开发者、东南亚/印度等 Firebase 友好的市场。

准备工作

1. Node.js 18+(Cloud Functions 需要)
   
2. Firebase 账号:https://firebase.google.com/
   
3. Firebase CLI:npm install -g firebase-tools,然后 firebase login
   
4. Claude Code / Cursor / Cline:支持 MCP 的 AI 客户端
   

3 步快速上手

第 1 步:安装 Skill(以 MCP 形式)

在 Claude Code 中:

claude mcp add --transport http firebase https://mcp.firebase.google.com/<br>
```<br>
仓库:https://github.com/firebase/agent-skills<br>
### 第 2 步:验证 Skill<br>
向 AI 询问:<br>
```<br>
请用 firebase Skill,列出当前项目下所有的 Firestore 集合<br>
```<br>
如果 AI 返回了实际集合名(或空列表),说明 MCP 连通成功。<br>
### 第 3 步:用 Skill 部署第一个云函数<br>
```<br>
用 firebase Skill,帮我在 functions/ 目录下写一个 HTTP 触发的函数,<br>
POST /hello 返回 { msg: "hi" },然后部署到生产<br>
```<br>
AI 会自动生成 `functions/src/index.ts`、配置 CORS、执行 `firebase deploy --only functions`。<br>
## 常见踩坑<br>
1. **Firestore 安全规则默认允许读写**:新建项目后前 30 天规则是 test mode(任何人可读写),30 天后或部署后规则收紧,务必上线前改规则。<br>
2. **Realtime DB 与 Firestore 选错**:Realtime DB 适合"持续同步、节点少"(如在线状态),Firestore 适合"查询复杂、文档结构"(如商品列表),不要混用。<br>
3. **Cloud Function 冷启动**:Node.js 运行时冷启动 200ms-2s,实时接口建议用 `setGlobalOptions({ minInstances: 1 })` 预热。<br>
4. **Firestore 写入费用**:Firestore 按"读/写/删除次数"计费,全表扫描 1 万次就要 0.18 美元,务必建索引、限制查询范围。<br>
5. **Auth 集成错误**:前端代码里残留了 admin SDK(只有后端能用),会导致密钥泄露在前端 bundle。Skill 会主动提示。<br>
6. **Hosting SPA rewrite 没配**:Vue/React 项目部署后刷新页面 404,需要在 `firebase.json` 加 `"rewrites": [{ "source": "**", "destination": "/index.html" }]`。<br>
## 初级用法<br>
1. **邮箱密码登录**:前端用 `signInWithEmailAndPassword`,后端用 Admin SDK 验证 token,中间通过 Firestore 存用户 profile。<br>
2. **Firestore CRUD**:`db.collection('todos').add({ text: 'x', done: false })`,自动得到唯一 ID,SDK 监听 `onSnapshot` 实时更新。<br>
3. **Hosting 部署**:`firebase init hosting` 初始化,`firebase deploy` 一键上线,自带 CDN 和 HTTPS。<br>
## 高级玩法<br>
1. **Cloud Functions 触发器**:监听 Firestore 文档变更(`onDocumentCreated`),自动做下游处理(如发邮件、写日志)。<br>
2. **Authentication + 自定义 Claims**:把用户角色(`admin` / `user`)写入 JWT claims,前端用 `getIdTokenResult()` 读取,后端校验,实现 RBAC。<br>
3. **Remote Config 灰度发布**:不上传新版本就能切换功能开关,适合做 A/B 测试和紧急回滚。<br>
## 小技巧<br>
- Firestore 查询用 `where` + `orderBy` + `limit`,避免一次拉太多数据。<br>
- 用 `enableIndexedDbPersistence()` 开启本地缓存,离线时仍可读写,网络恢复后自动同步。<br>
- Cloud Function 部署前用 `firebase emulators:start` 本地模拟,免去每次部署到远程测试。<br>
- 启用 App Check 防止 API 滥用,Firebase 提供 reCAPTCHA v3 集成。<br>
- 监控用 `firebase crashlytics:upload-symbols`,iOS/Android 都要上传符号表,否则崩溃栈是十六进制。<br>
- 用 `firebase functions:secrets:set` 存敏感配置(API Key、数据库密码),不要写死在代码里。<br>
## 常见问题 FAQ<br>
**Q1: 这个 Skill 跟 firebase 有什么关系?必须装吗?**<br>
A: Skill 是给 AI Agent 用的"技能包",能告诉 Agent 怎么按特定规范工作。**不是必须装**——如果你的项目规模小、要求不高,不装也能用。但装上能让 Agent 输出的质量更高、更符合最佳实践,推荐装。<br>

**Q2: 这个 Skill 适合哪些 AI Agent?Cursor?Claude Code?其他?**<br>
A: firebase 来自 community,主要面向支持 Skill 机制的 Agent。常见兼容 Agent 包括 Claude Code、Cursor、OpenCode、Windsurf 等。具体兼容性请查 Skill 官方文档。<br>

**Q3: 装了这个 Skill 后,会拖慢 Agent 响应吗?**<br>
A: 会的——Skill 通常会增加 prompt 长度,导致响应变慢、token 消耗增加。但质量提升明显。建议:1) 只装项目必需的 Skill;2) 用 Skill 启动/加载/卸载机制按需加载;3) 定期清理不用的 Skill。<br>

**Q4: 怎么验证 Skill 装对了?**<br>
A: 在 Agent 中输入"列出已加载的 Skill"或类似命令。如果 Skill 出现在列表里,说明装对了。然后用 Skill 跑一个相关任务,看输出是否符合 Skill 规范。<br>

**Q5: 这个 Skill 有许可证吗?能商用吗?**<br>
A: 取决于 firebase 的许可证。常见许可证包括 MIT(完全自由)、Apache-2.0(自由但有专利条款)、源可用(可看不能用)、GPL(强开源)。商用前请查仓库 LICENSE 文件。<br>
## 参考链接<br>
- [Skill 仓库](https://github.com/firebase/agent-skills)<br>
- [Firebase 官方文档](https://firebase.google.com/docs)<br>
- [Firestore 入门](https://firebase.google.com/docs/firestore/quickstart)<br>
- [Cloud Functions 文档](https://firebase.google.com/docs/functions)<br>
- [Firebase CLI 参考](https://firebase.google.com/docs/cli)<br>
- [安全规则示例](https://firebase.google.com/docs/rules)<br>
## 实战经验:Flutter + Firebase 跑通一个"云笔记"App<br>
下面用一个真实场景演示 firebase Skill 的端到端使用。<br>
**场景**:开发者要做一个 Flutter 移动端笔记 App,需要"邮箱密码注册/登录 + 笔记增删改查 + 实时同步"。<br>
### 步骤 1:初始化 Firebase 项目<br>
```bash<br>
flutterfire configure<br>
# 自动生成 firebase_options.dart,选中 Android/iOS/Web 平台<br>
```<br>
### 步骤 2:用 Skill 创建 Firestore 表结构<br>
```<br>
用 firebase Skill 在 Firestore 里建 notes 集合,字段:<br>
- userId: string<br>
- title: string<br>
- content: string<br>
- createdAt: timestamp<br>
- updatedAt: timestamp<br>
并配置安全规则:用户只能读写自己的 notes<br>
```<br>
AI 输出完整规则代码,直接粘贴到 Firebase Console 的 Rules 标签页。<br>
### 步骤 3:用 Skill 写 CRUD 代码<br>
```<br>
用 firebase Skill 写 Flutter 代码,实现:<br>
- 登录后进入 /notes 列表<br>
- 点击 + 弹新建表单<br>
- 列表项点击进详情页,可编辑保存<br>
- 多设备打开同一账号,实时看到对方编辑<br>
```<br>
AI 会给出 Auth 状态监听、Firestore `add` / `update` / `delete` / `onSnapshot` 的完整实现。<br>
### 步骤 4:部署 + 监控<br>
```bash<br>
firebase deploy --only firestore:rules,firestore:indexes<br>
firebase deploy --only functions<br>
```<br>
部署完后,在 Firebase Console 的 Crashlytics 标签看线上崩溃,Performance 标签看接口延迟。<br>
## 配合使用的工具链<br>
- **FlutterFire**:Firebase 官方 Flutter SDK,https://firebase.flutter.dev/<br>
- **Emulator Suite**:本地用 `firebase emulators:start` 模拟 Auth/Firestore/Functions,免去线上调试。<br>
- **Firebase Extensions**:官方扩展市场,如"Resize Images"(上传图片自动多尺寸)、"Trigger Email"(Firestore 文档变更触发邮件)。<br>
- **App Distribution**:把构建产物分发给测试人员,收集反馈。<br>
- **BigQuery Export**:把 Firestore 数据导出到 BigQuery 做 OLAP 分析,适合运营 dashboard。<br>
## 选 Firebase 还是自建后端?<br>
| 维度 | Firebase | 自建(Node/Go/Python) |<br>
|---|---|---|<br>
| 启动速度 | 快(SDK 几行代码) | 慢(要搭服务) |<br>
| 灵活度 | 中(受限于 API) | 高(完全自定义) |<br>
| 成本 | 早期低,大规模可能高 | 稳定可控 |<br>
| 数据迁移 | 难(Firestore NoSQL) | 易(标准 SQL) |<br>
| 适合场景 | 移动 App、MVP、实时场景 | 复杂业务逻辑、企业系统 |<br>
如果项目预计 2 年内要重构、查询复杂、需要事务一致性,慎选 Firestore;如果快速验证、移动优先、实时同步为主,Firebase 是稳妥选择。