Flutter 源码安装与升级：stable 通道、版本检查和回退
2026-09-10 修订：原文通过删除 Flutter 目录并克隆旧预发布分支升级，现已替换为先识别安装方式、再升级和验证的流程。本次依据官方资料校核，未在 macOS 执行升级实测。
1. 确认正在使用的 SDK
command -v flutter
which -a flutter
flutter --version
flutter channel
flutter doctor -v先保存项目代码、依赖锁文件与当前 SDK 版本。不要仅凭环境变量中出现 flutter 字符串判断真实安装目录，也不要先删除 SDK。
2. Git/手动管理的 SDK 使用标准升级流程
确认 SDK 没有需要保留的本地修改，并明确项目允许升级后，通常使用 stable 通道：
flutter channel stable
flutter upgrade切换通道与升级会改变 SDK；需要固定版本的项目应先阅读项目说明、SDK 归档和迁移指南，避免把机器上的所有项目同时切到一个新版本。
3. Homebrew 安装由 Homebrew 管理
brew update
brew upgrade --cask flutter选择与你原安装方式一致的升级途径。若已采用项目级版本管理，按该工具的规则执行，不要在同一个目录交叉使用多种管理方式。
4. 在项目中验证
flutter --version
flutter doctor -v
flutter pub get
flutter analyze
flutter test后三项在项目根目录运行；项目没有测试时，应补上实际运行检查，不能把“无测试”当成通过。依赖或 API 变更需要逐项处理，最后在目标设备或模拟器验证。
5. 出现回归时如何处理
保留失败日志与新旧版本号，查阅迁移说明。需要回退时使用事先记录的版本和锁文件，先在独立 SDK 目录验证，再调整项目指向；不要用删除工作目录或盲目清空缓存代替诊断。