在Android Studio创建Flutter项目时提示「Flutter create命令执行失败」错误

问题现象 #

每次在Android Studio中创建Flutter项目时，都会收到「项目创建错误。Flutter create命令执行失败」的提示，但项目文件仍会正常生成并填充内容。flutter doctor输出如下：

> F:\flutter\flutter\bin\flutter.bat doctor --verbose
[√] Flutter (Channel stable, 3.19.2, on Microsoft Windows [Version 10.0.19045.4046], locale en-IN)
    • Flutter version 3.19.2 on channel stable at F:\flutter\flutter
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision 7482962148 (7 days ago), 2024-02-27 16:51:22 -0500
    • Engine revision 04817c99c9
    • Dart version 3.3.0
    • DevTools version 2.31.1

[√] Windows Version (Installed version of Windows is version 10 or higher)

[√] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
    • Android SDK at F:\androidsdk
    • Platform android-34, build-tools 34.0.0
    • Java binary at: F:\Android\android studio\jbr\bin\java
    • Java version OpenJDK Runtime Environment (build 17.0.7+0-b2043.56-10550314)
    • All Android licenses accepted.

[√] Chrome - develop for the web
    • Chrome at C:\Program Files\Google\Chrome\Application\chrome.exe

[X] Visual Studio - develop Windows apps
    X Visual Studio not installed; this is necessary to develop Windows apps.
      Download at https://visualstudio.microsoft.com/downloads/.
      Please install the "Desktop development with C++" workload, including all of its default components

[√] Android Studio (version 2023.1)
    • Android Studio at F:\Android\android studio
    • Flutter plugin can be installed from:
       https://plugins.jetbrains.com/plugin/9212-flutter
    • Dart plugin can be installed from:
       https://plugins.jetbrains.com/plugin/6351-dart
    • Java version OpenJDK Runtime Environment (build 17.0.7+0-b2043.56-10550314)

[√] Connected device (3 available)
    • Windows (desktop) • windows • windows-x64    • Microsoft Windows [Version 10.0.19045.4046]
    • Chrome (web)      • chrome  • web-javascript • Google Chrome 122.0.6261.95
    • Edge (web)        • edge    • web-javascript • Microsoft Edge 122.0.2365.66

[√] Network resources
    • All expected network resources are available.

! Doctor found issues in 1 category

解决步骤 #

• 验证插件兼容性：打开Android Studio的Settings->Plugins，检查Flutter和Dart插件版本是否与当前Flutter SDK版本匹配，不兼容则升级插件。
• 手动执行命令排查：打开命令提示符，切换到目标目录执行flutter create test_project，查看命令行是否有具体错误输出。如果命令行执行成功，说明问题出在IDE插件层面。
• 处理Windows平台依赖：如果不需要开发Windows应用，创建项目时取消勾选Windows平台选项；如果需要，安装Visual Studio并添加「使用C++的桌面开发」工作负载。
• 清除IDE缓存：进入File->Invalidate Caches...，选择Invalidate and Restart，重启后重新尝试创建项目。
• 检查SDK路径配置：确认Android Studio中Settings->Languages & Frameworks->Flutter的SDK路径正确，路径避免包含中文或特殊字符。
• 更新Flutter SDK：执行flutter upgrade命令将SDK更新到最新稳定版，修复已知的命令执行问题。

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