如何在Android Studio中将现有Flutter项目切换为离线模式

结论先行：这种切换完全支持，不需要删除重建项目，所有配置调整都可以在现有项目结构上完成。

前置准备 #

• 提前下载和项目当前使用版本完全匹配的Flutter SDK离线完整包（包含全平台引擎、依赖索引、构建工具链），避免版本错位导致的构建失败
• 暂时关闭Android Studio内置的“自动同步依赖时联网拉取”选项，防止配置过程中触发非预期的网络请求

具体操作流程 #

• 调整项目关联的SDK路径
  打开项目目录下.idea/flutter.xml配置文件，定位到SDK路径的配置字段，把原本指向在线版Flutter SDK的路径，替换为本地存储的离线版SDK绝对路径。修改完成后重启Android Studio，等待IDE重新加载Flutter插件的SDK配置。
• 开启Flutter环境的离线全局开关
  打开终端，进入当前项目的根目录，执行flutter config --offline命令，命令执行成功后，当前关联的Flutter环境会默认启用离线依赖拉取逻辑，跳过所有pub.dev的联网请求。
• 补全项目本地依赖缓存
  在项目根目录执行flutter pub get --offline，IDE会从本地pub依赖缓存目录中匹配并拉取pubspec.yaml声明的所有依赖。如果出现依赖缺失的报错，需要将对应版本的依赖包手动放入本地Flutter的pub缓存目录，重新执行该命令直到拉取完成。
• 离线配置有效性验证
  断开本地设备的公网连接，在项目根目录执行flutter run尝试构建启动项目，如果全程没有出现网络请求相关的报错、可以正常将应用安装到模拟器/实体设备，就代表离线配置已经全部生效。

常见注意点 #

• 离线模式无法拉取本地未缓存过的新依赖版本，如果后续需要新增第三方库，需要临时执行flutter config --online切回在线模式，拉取一次对应依赖的本地缓存后，再切回离线模式使用
• 配置过程中不要随意更换离线SDK的小版本，否则会因为Flutter引擎版本和项目编译产物不匹配，出现运行时的兼容性异常

内容的提问来源于stack exchange，提问作者Mohammed Ali