Flutter无法在Android设备运行：VSCode新建项目编译Aidl失败

这个问题我帮不少开发者排查过，从错误信息来看，核心问题就是你的Android Build Tools 26.0.2版本里确实缺少aidl工具，或者SDK的路径配置出了问题。下面是几个一步步就能解决的方案：

方案1：升级Build Tools到稳定新版本 #

26.0.2是比较老旧的版本，官方后续修复了不少文件缺失的问题，升级到更高的稳定版本是最省心的办法：

• 打开Android Studio的SDK Manager（可以通过Tools > SDK Manager打开）
• 切换到SDK Tools标签，找到Android Build Tools
• 取消勾选26.0.2，选择一个更高的稳定版本（比如28.0.3、30.0.3这类），点击Apply安装
• 打开项目里android/app/build.gradle文件，找到buildToolsVersion这一行，修改为你刚安装的版本，比如：

  buildToolsVersion "30.0.3"
  

• 最后在终端运行flutter clean清除缓存，再执行flutter run试试

方案2：检查并修复Android SDK路径配置 #

有时候Flutter没正确识别到你的SDK路径，也会导致找不到aidl工具：

• 先在终端运行flutter doctor，看看输出里的Android SDK配置是否显示正常
• 如果路径不对，需要手动设置环境变量：
  • macOS/Linux：打开终端，编辑~/.zshrc（或者~/.bash_profile，取决于你用的shell），添加一行：

    export ANDROID_SDK_ROOT=/Users/sachin/Library/Android/sdk
    

    然后运行source ~/.zshrc让配置生效
  • Windows：打开系统环境变量设置，新建ANDROID_SDK_ROOT变量，值设为你的SDK路径（比如C:\Users\你的用户名\AppData\Local\Android\Sdk）
• 接着运行flutter doctor --android-licenses，按提示接受所有Android许可证，之后再重试flutter run

方案3：重新安装Build Tools 26.0.2（如果必须用这个版本） #

如果你因为项目依赖必须保留26.0.2版本，可以尝试重新安装来修复文件缺失：

• 打开SDK Manager，找到26.0.2版本的Build Tools，先点击Uninstall卸载
• 卸载完成后，重新勾选26.0.2并安装，确保下载过程网络稳定，避免文件损坏
• 安装完成后，运行flutter clean再编译测试

额外小提示 #

• 可以试试用真实Android设备测试，有时候老旧模拟器的系统版本和Build Tools兼容性不好
• 确保你的Flutter SDK是最新的，运行flutter upgrade升级到稳定版再尝试

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