Android Studio下特定Flutter文件按Command+S无法热重载、跳转类声明异常

现象说明 #

Command+S保存触发的自动reload、代码跳转功能都依赖Android Studio内置的Dart分析服务索引，而点击闪电图标触发的hot reload走的是Flutter CLI的编译校验逻辑，只要代码实际语法没有问题就可以正常执行，两者校验逻辑独立，所以会出现功能不一致的问题。

解决方案 #

• 第一步：检查异常文件的导入语法
  1. 确认所有导入路径大小写和实际文件完全一致：Dart分析器大小写敏感，macOS文件系统默认大小写不敏感，会出现实际文件能找到但分析器索引失败的问题，比如实际文件为UserInfo.dart，导入语句写成import 'userinfo.dart'就会触发异常
  2. 排查是否存在循环导入：如果当前文件和其他文件形成A导入B、B导入A的循环引用，会导致Dart分析器局部解析中断，只会影响涉及循环的少数文件
• 第二步：重置Dart分析服务局部缓存
  1. 打开Android Studio的Preferences > Languages & Frameworks > Dart
  2. 确认已勾选Enable Dart support for the project <你的项目名称>，且Dart SDK路径为Flutter内置的SDK路径（不要使用单独下载的独立Dart SDK）
  3. 点击页面底部的Clear caches按钮，等待Dart分析服务重启即可，不需要重启整个IDE
• 第三步：校验pubspec.yaml配置
  1. 确认pubspec.yaml中的name字段值和你项目内package导入的前缀完全一致：比如pubspec中name配置为shop_app，项目内的package导入必须为import 'package:shop_app/xxx/xxx.dart'，前缀不匹配会导致局部索引失效
  2. 执行flutter pub get重新刷新依赖索引
• 第四步：确认文件未被排除索引
  右键点击异常文件，选择Mark Directory as，确认没有被标记为Excluded或者Generated Sources Root，如果被标记，选择Mark as Sources Root恢复索引

如果以上步骤执行后问题仍未解决，新建一个.dart文件，将异常文件的内容完整复制到新文件，删除原异常文件后将新文件重命名为原文件名即可修复。

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