Flutter Setup Doctor

flutter-setup-doctor 是一个主要面向 macOS 的 Flutter 开发环境搭建的 Skill。

是什么

这个 Skill 用来解决一个很具体的问题：

如何用一套相对统一的标准，手把手教你快速搭建出 Flutter 应用开发所必须的软件运行环境，尽可能降低入门 Flutter 应用开发的门槛。

因此，这个 Skill 更接近“标准化装机流程”。

怎么用

直接用自然语言提出目标即可：

帮我在 macOS 上一步一步搭建 Flutter 开发环境

基本工作流

整个流程固定分成五个阶段：

1. macOS 与基础 CLI 检查
2. FVM 与 Flutter SDK
3. Android 工具链
4. iOS 工具链
5. 设备与 smoke test

核心原理

这个 Skill 的核心原理不是“收集安装命令”，而是四条执行原则。

1. 分步门禁

每一步都必须单独过关。只有当前步骤完成并验证通过，才允许继续后面的步骤。

这样可以避免一个前置错误在后续步骤里不断放大，最后变成难以定位的混合问题。

2. 默认路径收敛

• 用fvm 做好 Flutter SDK 版本管理
• Android Studio 走 Homebrew Cask
• Xcode 走 App Store

这样做的目的不是限制自由，而是减少环境分叉，保证不同机器最后得到的是同一种结果。

3. GUI 与 CLI 分离

凡是必须经过图形界面的步骤，例如 Android Studio 首次向导、插件安装、Xcode 首次打开，这个 Skill 都会明确要求用户亲自完成并确认。

它不会把这些步骤伪装成“已经自动完成”，因此流程状态更真实，也更适合培训和批量装机场景。

4. 以可运行为准

环境是否完成，不以“命令跑过”或“doctor 看起来差不多”作为标准，而是以最终是否能在真实设备或模拟器上跑起最小 Flutter 应用为准。

补充

仓库中的核心文件包括：

• SKILL.md：定义触发范围、整体流程、门禁规则和输出格式
• references/：按步骤拆开的详细参考说明
• scripts/：用于辅助检查和 smoke test 的脚本