Flutter项目编译出现Java错误 VS Code无法识别已安装JDK 11

按以下步骤逐一排查配置，即可解决Java环境识别失败导致的编译报错：

• 确认本地JDK 11的真实安装路径
  打开系统终端执行对应命令查询：
  • Windows：where java
  • macOS/Linux：which java
    注意：记录返回的JDK根目录路径，不要取bin目录下java可执行文件的单文件路径。Windows下典型路径为C:\Program Files\Java\jdk-11.0.xx，macOS下典型路径为/Library/Java/JavaVirtualMachines/jdk-11.0.xx.jdk/Contents/Home
• 配置系统全局JAVA_HOME环境变量
  • Windows：打开系统环境变量设置面板，新建系统变量，变量名填JAVA_HOME，变量值填之前记录的JDK根目录路径；随后编辑系统Path变量，新增%JAVA_HOME%\bin条目。保存配置后重启终端，执行java -version和javac -version，确认两个命令均返回JDK 11的版本信息。
  • macOS/Linux：根据当前使用的shell编辑对应配置文件（zsh用户编辑~/.zshrc，bash用户编辑~/.bash_profile），写入两行配置：

    export JAVA_HOME=你记录的JDK根目录路径
    export PATH=$JAVA_HOME/bin:$PATH
    

    保存后执行source 对应配置文件路径让配置生效，同样执行版本校验命令确认配置正确。
• 修正VS Code侧的Java识别配置
  1. 完全退出所有VS Code进程后重启软件，避免旧配置缓存影响
  2. 打开VS Code设置（快捷键Ctrl+, 或 Cmd+,），搜索java.jdt.ls.java.home配置项，填入之前记录的JDK 11根目录路径
  3. 确认Flutter、Dart插件已正常启用，打开命令面板执行Flutter: Clean Project清理项目旧编译缓存
• 锁定Flutter编译使用的JDK版本
  在终端进入项目根目录，执行命令：
  flutter config --jdk-dir="你记录的JDK 11根目录路径"
  执行完成后跑flutter doctor，检查输出中Java条目是否正常识别为JDK 11，若存在其他红色报错项按提示逐一修复即可。

常见踩坑提醒：不要将Java安装时自动生成的C:\Program Files\Common Files\Oracle\Java\javapath这类快捷路径设为JAVA_HOME，这类路径缺少JDK完整的编译工具链，会触发Gradle编译失败；如果本地安装了多个JDK版本，必须保证系统全局配置、VS Code配置、Flutter配置指向同一个JDK 11路径，避免版本冲突。

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