要把 Flutter 跑起来，核心是三件套：Flutter SDK + 编辑器（推荐 VS Code）+ 平台工具链（Android / iOS）。先明确目标：只做 Android 只需 Android 工具链；要跑 iOS 必须是 macOS + Xcode。
建议版本策略：优先使用 Flutter stable；Android 端使用 Android Studio 的 SDK Manager 统一管理 SDK/Build-Tools；iOS 端用 Xcode 官方版本，避免 beta 引发签名/兼容问题。
从 Flutter 官方渠道获取 stable 版本，解压到无中文、无空格路径（例如：Windows 放在 C:\dev\flutter；macOS 放在 ~/dev/flutter）。
配置 PATH：把 flutter/bin 加入系统环境变量（或 shell 配置），让命令行能直接运行 flutter。
验证：打开终端执行 flutter --version，能输出版本号即说明 SDK 可用。
如果你在网络环境下拉取依赖较慢，可以配置 Flutter 相关镜像环境变量，避免频繁卡在 pub get / engine 下载。镜像地址以你实际网络可用为准，建议在团队内统一规范。
提示：镜像只是加速下载，不会改变代码逻辑。遇到依赖解析异常时，先切回默认源对比排查。
安装 Android Studio 后，打开 SDK Manager：
1）安装常用的 Android SDK Platform（建议至少覆盖你要支持的最低版本到最新稳定版本）。
2）安装 Android SDK Build-Tools 与 Platform-Tools（含 adb）。
3）需要模拟器则安装 Android Emulator，并在 AVD Manager 创建设备。
检查点：终端执行 adb version，能输出版本说明 adb 可用。
在 Mac 上安装 Xcode，并在首次启动后完成组件安装。然后在终端执行：
xcode-select --install（安装命令行工具）
iOS 依赖通常通过 CocoaPods 管理。若提示缺少 pods，按提示安装并在项目 iOS 目录执行 pod install（通常 Flutter 会自动引导）。
注意：不要从不明来源安装修改版 Xcode，也不要使用来路不明的证书/签名配置。
在 VS Code 安装以下插件：
- Flutter
- Dart
然后打开你的 Flutter 项目目录，按 F5 选择设备即可调试。建议开启格式化与分析（Dart Analyzer），让代码风格一致、问题提前暴露。
在终端运行：
flutter doctor
它会列出 Android/iOS/编辑器/网络等依赖状态。你的目标是：与当前目标平台相关的项目尽量全绿。
常见问题与处理方向：
1）提示找不到 Android SDK：检查 Android Studio 的 SDK 路径设置与环境变量。
2）提示 licenses 未接受：按 doctor 输出的命令接受协议。
3）iOS 签名问题：确认 Apple ID 登录、开发者证书与团队设置正确（不建议用来源不明的配置）。
Android：手机打开开发者选项与 USB 调试，连接后执行 flutter devices 应能看到设备；首次可能需要在手机上确认授权。
iOS：用数据线连接 iPhone，在 Xcode 的设备列表中能看到设备；首次部署需要信任开发者与配置签名。然后在 Flutter 中选择该设备运行即可。
1）统一 Flutter SDK 版本：团队建议使用 FVM 等工具固定版本，避免“我能跑你不能跑”。
2）依赖升级有节奏：定期升级小版本并在 CI 上验证；重大升级单独开分支。
3）缓存与构建问题：遇到奇怪的构建错误，优先执行 flutter clean 再重试。
新建项目后跑通一次：创建项目 → 获取依赖 → 选择设备 → 运行。只要这个链路稳定，你的 Flutter 环境就算真正搭好。
