Android 开发时报错 avdmanager is missing from the Android SDK
这是在配置 Flutter 调试环境时非常经典的问题。通常是因为较新版本的 Android Studio 默认不再安装 Android SDK Command-line Tools。
通过以下步骤快速找回它:
1. 通过 Android Studio 安装 (最简单)
即使你平时用 VS Code,也建议用 Android Studio 的图形界面来补全这个组件:
- 打开 Android Studio。
- 进入 Settings (Windows/Linux) 或 Settings/Settings... (macOS)。
- 导航到:Languages & Frameworks -> Android SDK。
- 切换到 SDK Tools 选项卡。
- 找到 Android SDK Command-line Tools (latest),勾选它。
- 点击 Apply 或 OK 进行下载安装。

2. 检查环境变量
安装完成后,系统需要知道 avdmanager 在哪里。它通常位于以下路径:
- Windows:
%LOCALAPPDATA%\Android\Sdk\cmdline-tools\latest\bin
- Linux:
$ANDROID_HOME/cmdline-tools/latest/bin
- macOS:
~/Library/Android/sdk/cmdline-tools/latest/bin
重要提示: 如果你的路径里是 cmdline-tools/1.0/bin 这种带版本号的,建议手动把文件夹重命名为 latest(或者在里面嵌套一层 latest),因为 Flutter 的自动化脚本通常只认这个路径。
3. 验证并接受协议
组件装好后,你需要让 Flutter 重新识别并同意 Android 协议。在 VS Code 终端输入:
flutter doctor --android-licenses
按提示一直输入 y 即可。
测试:
flutter doctor -v
可以看到下述信息,说明已经正常安装。
[✓] Android toolchain - develop for Android devices (Android SDK version 36.1.0) [1,167ms]
4. 为什么我还是在 VS Code 里看不到 AVD?
如果 avdmanager 找回来了,但 VS Code 底部还是没有模拟器:
- 刷新列表: 点击右下角的设备名称,选择 Refresh。
- 手动创建: 如果你还没创建过模拟器,VS Code 可能会提示 "Create Android emulator"。
- 检查 Flutter Doctor: 运行
flutter doctor。如果它显示 [✓] Android toolchain 是绿色的钩,说明 avdmanager 已经修好了。
避坑小贴士
有些老旧教程会让你去找 tools/bin 下的 avdmanager。请无视它。Google 已经在几年前废弃了旧版的 SDK Tools,现在统一使用 cmdline-tools。
现在你的 flutter doctor 运行结果中,Android 这一项是绿色的了吗? 如果还有报错,请把错误信息贴给我。