VSCode创建Flutter模拟器提示avd not created错误如何解决

核心原因 #

VSCode的Flutter插件创建AVD时会吞掉底层工具的详细报错，之前通过Android Studio删除模拟器大概率留下了配置残留，或是SDK路径、环境变量、系统镜像存在异常，按以下步骤从易到难排查：

• 第一步：清理旧AVD残留配置
  进入本地AVD默认存储路径：
  • Windows：C:\Users\<你的系统用户名>\.android\avd
  • macOS：~/.android/avd
  • Linux：~/.android/avd
    删除路径下所有和你之前删除的模拟器同名的.ini配置文件、同名AVD数据文件夹，不要留冗余文件。
    之后打开VSCode按Ctrl+Shift+P（macOS快捷键为Cmd+Shift+P）调出命令面板，执行Flutter: Clean Cache，重启VSCode后再尝试创建。
• 第二步：通过命令行定位真实报错
  VSCode的提示没有给出具体错误原因，直接调用Android SDK自带的avdmanager工具就能拿到完整报错：
  1. 新开终端执行flutter doctor -v，找到输出中Android SDK at后的路径，就是你本地的Android SDK根目录
  2. 进入SDK目录下的cmdline-tools/<版本号>/bin文件夹，在该路径下打开终端
  3. Windows系统执行avdmanager.bat list target，macOS/Linux执行./avdmanager list target，确认本地已安装可用的安卓系统镜像
  4. 执行创建命令测试（示例为创建安卓13、Pixel5规格的测试模拟器，参数可根据你本地已装镜像替换）：

     # Windows
     avdmanager.bat create avd -n test_avd -k "system-images;android-33;google_apis;x86_64" -d "pixel_5"
     # macOS/Linux
     ./avdmanager create avd -n test_avd -k "system-images;android-33;google_apis;x86_64" -d "pixel_5"
     

  命令执行后输出的报错就是根因，高频问题对应解决方式：
  • 提示找不到对应系统镜像：打开Android Studio的SDK Manager，安装对应安卓版本的Google APIs、x86_64架构系统镜像
  • 提示权限不足：Windows端给终端开管理员权限重新执行，macOS/Linux先执行chmod +x avdmanager给工具加执行权限
  • 提示磁盘空间不足：AVD默认存储在系统盘，至少预留5G以上空闲空间，也可以配置AVD存储路径到其他空间充足的盘符
• 第三步：校验环境变量配置
  检查系统环境变量：
  1. 确认ANDROID_HOME/ANDROID_SDK_ROOT变量值为你本地真实的Android SDK路径，不存在指向旧目录、不存在路径的问题
  2. 将SDK路径下的platform-tools、cmdline-tools/latest/bin、emulator三个子目录添加到系统Path变量中
  3. 配置完成后新开终端执行flutter doctor，确认Android工具链项无红叉报错，按提示修复所有问题后再尝试创建AVD
• 兜底方案
  如果以上步骤都没解决，直接打开Android Studio进入Device Manager，正常创建一个可以在AS端正常启动的AVD，重启VSCode后Flutter插件会自动识别到已存在的模拟器，不需要在VSCode端重复创建。如果识别不到，执行flutter config --android-sdk <你的SDK实际路径>手动指定SDK位置，再执行flutter emulators确认能列出已创建的模拟器即可。

注意：如果你的系统用户名是中文，或是SDK/AVD存储路径包含空格、特殊字符，100%会触发AVD创建失败，需要把SDK、AVD目录移动到纯英文无特殊字符的路径下，再修改对应配置文件里的路径指向。

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