用途：指导在 Flutter 应用中正确安装、配置与初始化 Firebase，适用于首次接入 Firebase、新增 Firebase 服务或平台后重跑 flutterfire configure、在 main.dart 初始化，以及为多套应用风味配置独立 Firebase 项目。
主要能力：安装工具链（npm install -g firebase-tools、firebase login、dart pub global activate flutterfire_cli）；在项目目录运行 flutterfire configure 生成配置；添加核心包 flutter pub add firebase_core；新增平台或服务后重跑 configure；Android 专用服务（Crashlytics、Performance Monitoring）由 CLI 自动添加所需 Gradle 插件；新增插件后用 flutter run 重新构建。
初始化方式：在 main 中先调用 WidgetsFlutterBinding.ensureInitialized()，再用 Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform) 初始化，且需置于其他 Firebase 服务调用之前。firebase_options.dart 为自动生成，不要手动修改，但应提交到版本控制（含非机密配置标识）。使用模拟器套件时可用 await Firebase.initializeApp(demoProjectId: "demo-project-id")。
多风味：为开发、预发、生产分别创建 Firebase 项目，用 flutterfire config 指定 --project、--out、--ios-bundle-id、--ios-out、--android-package-name、--android-out 等参数；按风味以命名空间别名导入各自配置，通过 appFlavor 或环境变量在运行时选择配置，可用辅助脚本自动化。
验证与限制：运行 flutter run 确认无初始化错误，检查调试控制台与 firebase_options.dart 中的项目 ID；建议启用 Analytics，跨平台使用一致项目，iOS/macOS 部分服务需在 Xcode 添加 Keychain Sharing，并在 debug 与 release 构建下测试，注意插件与 Firebase SDK 版本兼容。最低平台要求：Android API 19 及以上，iOS 11 及以上。其他细节暂未提供。