外部终端正常但VSCode终端提示Unable to locate Android SDK求助

问题现象 #

系统主终端执行flutter doctor时检测正常，但VSCode内置终端执行同一命令时，出现“Unable to locate Android SDK”错误。

主终端运行结果：

VSCode终端运行结果：

原因分析 #

VSCode内置终端未正确继承系统主终端的环境变量，导致Flutter无法识别Android SDK的路径配置。

解决方案 #

• 检查终端环境变量
  在VSCode终端执行对应命令查看ANDROID_HOME配置：

  • Linux/macOS：echo $ANDROID_HOME
  • Windows：echo %ANDROID_HOME%
    若无输出，说明环境变量未加载。

• 手动配置VSCode中的Android SDK路径
  打开VSCode设置（快捷键Ctrl+,/Cmd+,），分别搜索并配置：

  • android.sdkPath：填入你的Android SDK实际安装路径，例如C:\Users\用户名\AppData\Local\Android\Sdk（Windows）或/Users/用户名/Library/Android/sdk（macOS）
  • 同时确认flutter.sdk和dart.sdk路径配置正确

• 确保VSCode终端继承系统环境变量

  • Windows：右键以管理员身份启动VSCode，或确认终端使用系统默认的PowerShell/CMD
  • macOS/Linux：检查VSCode的终端shell配置（设置中搜索terminal.integrated.profiles.osx/terminal.integrated.profiles.linux），确保使用的shell（如zsh/bash）会加载~/.zshrc/~/.bashrc中的环境变量配置，确认其中包含：

    export ANDROID_HOME=/你的AndroidSDK路径
    export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools
    

• 重启验证
  关闭所有VSCode窗口后重新打开，再次执行flutter doctor确认问题解决。

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