VSCode新建Flutter项目运行Windows端报--platforms参数不支持错误

问题现象 #

在VSCode中创建的全新Flutter项目尝试运行Windows桌面端时抛出错误：The "--platforms" argument is not supported in module template。

复现步骤 #

• 在VSCode中创建全新的默认Flutter应用
• 执行命令flutter config --enable-windows-desktop开启Windows桌面端支持
• 执行命令flutter devices查看可用设备，输出如下：

Windows (desktop) • windows • windows-x64    • Microsoft Windows [Version 10.0.19043.1766]
Chrome (web)      • chrome  • web-javascript • Google Chrome 103.0.5060.66
Edge (web)        • edge    • web-javascript • Microsoft Edge 103.0.1264.44

• 在VSCode中选择无调试模式运行应用，点击Enable Windows for this Project选项后，抛出如下错误：

flutter create --platforms windows .
The "--platforms" argument is not supported in module template.
exit code 2

环境检测结果 #

执行flutter doctor检测开发环境，所有项均正常无报错，输出摘要如下：

[√] Flutter (Channel stable, 3.0.4, on Microsoft Windows [Version 10.0.19043.1766], locale en-GB)
[√] Android toolchain - develop for Android devices (Android SDK version 30.0.3)
[√] Chrome - develop for the web
[√] Visual Studio - develop for Windows (Visual Studio Community 2022 17.0.6)
[√] Android Studio (version 4.2)
[√] VS Code (version 1.68.1)
[√] Connected device (3 available)
[√] HTTP Host Availability
• No issues found!

补充说明：通过命令行flutter create命令创建的同款应用可正常运行，问题由VSCode侧触发。

问题原因 #

报错核心原因是当前项目被识别为Flutter Module混编模板，这类模板用于将Flutter嵌入现有原生Android/iOS项目，不支持通过--platforms参数新增桌面端平台配置。该问题一般是两种情况导致：

1. VSCode中新建Flutter项目时误选了Flutter Module选项，而非标准的Flutter Application应用模板
2. VSCode安装的Flutter/Dart插件存在缓存异常，新建项目时默认套用了Module模板配置

解决方法 #

• 方法一（推荐，无代码损失）：
  打开项目根目录下的.metadata文件，找到project_type字段，将值从module修改为app，保存后重启VSCode，再次点击Enable Windows for this Project即可正常生成Windows平台配置。
• 方法二（无需手动改配置文件）：
  直接在项目根目录打开终端，手动执行命令flutter create . --platforms=windows,android,ios,web，强制将当前目录初始化为标准Flutter应用模板并补全所有平台配置，执行完成后重启VSCode即可选择Windows设备运行。
• 方法三（彻底规避后续问题）：
  如果多次新建项目都出现该问题，卸载VSCode中已安装的Flutter、Dart插件，重启VSCode后重新安装两个插件，新建项目时手动确认选中Flutter Application模板即可。

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