Flutter项目打开MainActivity.kt提示“Project JDK is not defined”错误求助

• IDE（Android Studio/VSCode）未正确识别项目关联的JDK路径，Flutter的Android模块编译依赖JDK，找不到有效JDK就会触发该错误及代码高亮异常。
• 具体诱因包括：
  • 未安装JDK 11及以上版本（Flutter Android端要求最低JDK 11）；
  • IDE全局或项目级的JDK配置指向无效路径；
  • 项目local.properties文件中jdk.dir配置错误或缺失；
  • 双IDE使用时，其中一方的配置未同步，导致打开项目时识别异常。

Android Studio 操作步骤 #

1. 检查并配置项目JDK：打开File > Project Structure > SDK Location，确认JDK Location有有效路径。无路径时可点击下拉选择已安装的JDK，或点击Download下载官方JDK 11。
2. 配置Gradle关联JDK：打开File > Settings > Build, Execution, Deployment > Build Tools > Gradle，在Gradle JDK选项中选择正确版本，也可直接使用Android Studio自带的Embedded JDK（推荐）。
3. 修复项目配置文件：打开项目根目录下的local.properties，若存在jdk.dir字段则确保路径正确，无此字段可手动添加：

   jdk.dir=/path/to/your/jdk  # macOS/Linux示例
   # Windows示例：jdk.dir=C:\\Program Files\\Java\\jdk-11.0.16
   

4. 同步项目：点击右上角的Sync Project with Gradle Files按钮，等待同步完成后错误会自动消除。

VSCode 操作步骤 #

1. 安装必要插件：确保已安装Extension Pack for Java插件，该插件负责JDK识别与Java代码支持。
2. 配置JDK路径：打开设置（快捷键Ctrl+,），搜索java.home，点击Edit in settings.json，添加JDK绝对路径：

   "java.home": "/Library/Java/JavaVirtualMachines/jdk-11.jdk/Contents/Home"  // macOS示例
   // Windows示例："java.home": "C:\\Program Files\\Java\\jdk-11.0.16"
   

3. 配置Flutter全局JDK：打开终端执行命令：

   flutter config --android-jdk /path/to/your/jdk
   

4. 重启VSCode：配置完成后重启编辑器，重新打开MainActivity.kt文件即可解决错误。

• 务必使用JDK 11及以上版本，低版本JDK会导致Flutter Android编译不兼容；
• 双IDE使用时，尽量保持两者的JDK配置一致，避免跨IDE打开项目时出现识别异常。

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