Android Studio中Flutter与Dart SDK路径不生效无法切换正确版本

针对IDE偏好显示的SDK版本与实际构建调用版本错位、版本不兼容报错的问题，核心诱因是多层级SDK路径配置优先级错乱，可按以下顺序逐一排查修复：

1. 优先排查系统环境变量优先级问题 #

Android Studio的构建进程会优先继承系统启动时加载的shell环境变量，优先级高于IDE内部的偏好设置。

• 打开独立的系统终端（不要使用Android Studio内置终端，避免IDE缓存干扰结果），执行命令查看当前全局生效的Flutter实际路径：which flutter
• 若返回路径指向旧版本Flutter 1.22.6目录，直接调整环境变量配置：
  • 检查shell配置文件（.zshrc/.bashrc/.bash_profile）中的PATH导出语句，将新版本Flutter的bin目录条目移到旧版本条目前面，清理重复指向旧版本的残留配置行
  • 检查系统级环境变量的PATH列表，调整顺序后重启终端验证配置是否生效

2. 逐层排查Android Studio内部的配置冲突 #

不要只依赖偏好设置界面的路径显示，Android Studio的Flutter SDK配置是分层的，低层级配置会被高层级配置覆盖，需逐一核对：

• 全局插件配置层
  打开Settings > Languages & Frameworks > Flutter，确认全局默认SDK路径没有被锁死为旧版本目录——很多时候项目内单独选中了新SDK，全局兜底配置仍指向旧路径，构建时会优先命中全局配置
• 项目缓存配置层
  打开项目下.idea/flutter.xml文件，检查文件内的flutterSdkPath字段，清除残留的旧版本SDK路径缓存
• Gradle构建层
  不要仅修改local.properties，需同步清理硬编码缓存：
  • 删除项目根目录下的.flutter-plugins、.flutter-plugins-dependencies两个隐藏缓存文件，这类文件会写入旧SDK的绝对路径，构建时会直接硬匹配读取
  • 检查Android模块下的build.gradle文件，删除硬编码指向旧SDK的flutter { source = 'xxx' }配置段

3. 修复版本错位导致的构建报错 #

出现如下报错的本质是构建链路错用了Flutter 1.22.6（对应Dart 2.10.5），但项目代码是按Flutter 2.0.3（对应Dart 2.12.2）的规范编写的：
../../Developer/flutter_2.0.3/packages/flutter/lib/src/widgets/scroll_position.dart:1:1: Error: The specified language version is too high. The highest supported language version is 2.10.

• 路径配置全部核对完成后，在项目根目录执行flutter clean清除本地构建缓存
• 核对pubspec.yaml中的SDK版本约束，确保和实际选用的Flutter版本匹配，不要为了适配旧版本手动降级代码的语言约束

必做收尾步骤 #

• 确认两个Flutter版本的存放路径没有交叉软链接，避免SDK识别混乱
• 所有配置修改完成后，完全退出Android Studio再重启：Android Studio的环境变量是启动时一次性加载的，仅刷新项目不会加载新的环境配置

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