CentOS 中 Flutter 更新操作指南
一 快速升级到最新稳定版
- 查看当前版本与渠道：运行命令查看 Flutter 与 Dart 版本、当前 channel（如：stable、beta、dev、master）。
- 命令：
flutter --version、flutter channel
- 切换到目标渠道（可选）：如需从 dev 切到 stable，先切换再升级更稳定。
- 命令：
flutter channel stable
- 执行升级：升级 SDK 到当前渠道的最新版本。
- 验证升级结果：确认版本号与工具链是否正常。
- 命令：
flutter --version、flutter doctor
- 如命令未找到，检查 PATH 是否包含 Flutter 的 bin 目录（例如：
/opt/flutter/bin）。
二 升级到指定版本或回退版本
- 指定版本升级：直接升级到某个版本号（示例为 3.10.5）。
- 命令：
flutter upgrade 3.10.5
- 回退到历史版本（手动方式）：进入 Flutter SDK 安装目录（该目录是一个 Git 仓库），重置到目标 commit。
- 步骤：
- 进入目录：
cd /opt/flutter
- 查看提交历史并复制目标 commit id：
git log --oneline -10
- 回退：
git reset --hard <commit_id>
- 校验：
flutter --version
- 说明：回退会同步切换对应的 Dart SDK，网络不稳可能导致下载中断。
三 使用 FVM 进行多版本管理与升级（推荐用于多项目）
- 安装 FVM（Dart 全局工具）：
- 命令：
dart pub global activate fvm
- 安装与切换版本：
- 安装指定版本或渠道：
fvm install stable、fvm install 3.16.9
- 为当前项目使用版本：
fvm use 3.16.9（会在项目根目录生成 .fvm/flutter_sdk 软链）
- 全局默认版本：
fvm use 3.16.9 --global
- 升级策略：
- 全局升级：
flutter upgrade（影响 FVM 的全局版本）
- 项目级升级：在项目目录执行
fvm flutter upgrade（只升级该项目所使用的 SDK 副本）
- 常用辅助命令：
- 列出已安装版本：
fvm list
- 删除版本：
fvm remove 3.16.9
- IDE 集成：将 Android Studio/VS Code 的 Flutter SDK 路径指向项目下的 .fvm/flutter_sdk
- 建议将 .fvm/ 加入 .gitignore，避免误提交。
四 升级后的项目依赖与验证
- 获取/升级依赖：
- 安装依赖：
flutter pub get
- 升级依赖：
flutter pub upgrade（或指定包：flutter pub upgrade <package_name>）
- 清理与重建（遇到依赖冲突或异常时）：
- 清理：
flutter clean
- 重新获取：
flutter pub get
- 兼容性检查与修复：
- 运行
flutter doctor 检查环境与健康度
- 若出现 “依赖包要求 Flutter 版本较低/较高” 的冲突，需升级/降级相关依赖或锁定兼容版本
- 回归测试：在升级 SDK 与依赖后，执行运行与关键业务测试，确保功能与性能正常。