Android Studio 2024.3.1 新建项目无 Flutter 选项，如何启用？

Question

**问题：** 在 Android Studio 2024.3.1（基于 IntelliJ 2024.3 平台）中新建项目时，Flutter 模板完全缺失（如无“Flutter Application”“Flutter Package”等选项），即使已安装 Flutter SDK 和 Dart 插件。这是为何？是否因新版 AS 默认移除了 Flutter 支持？如何安全、可靠地恢复新建 Flutter 项目的功能？需注意哪些关键步骤（如插件兼容性、SDK 路径配置、重启时机）？常见误区包括仅安装 Dart 插件而遗漏 Flutter 插件、未启用“Enable Dart support”项目级配置，或误用非官方 Flutter 插件分支。请提供适配 2024.3.1 的实操路径。

Answer 1

```html

一、现象定位：Flutter 模板为何在 AS 2024.3.1 中“凭空消失”？

Android Studio 2024.3.1（基于 IntelliJ IDEA 2024.3 平台）并未移除 Flutter 支持，但其项目向导（New Project Wizard）中 默认不显示 Flutter 模板，根本原因在于：Flutter 插件未启用或与平台版本不兼容，且新版 AS 强化了插件沙箱机制与模板注册生命周期。Dart 插件仅提供语言支持（语法高亮、分析器），而 Flutter Plugin 才负责注册项目模板、SDK 集成、设备管理及热重载入口。若该插件未安装/禁用/损坏，模板即不可见——这是最常见却最易被忽略的根源。

二、深度归因：四层技术栈断裂分析

• 平台层：IntelliJ 2024.3 引入了 Plugin Registration v2 协议，旧版 Flutter 插件（≤75.0.3）未适配此协议，导致模板注册失败；
• 插件层：官方 Flutter 插件（JetBrains Marketplace）自 v76.0.1+ 起正式支持 2024.3 平台，低于此版本将静默失效；
• 配置层：AS 启动时需加载 flutter.sdk.path 全局属性，若 SDK 路径含空格、中文、符号或指向非标准 flutter/bin 目录，插件初始化即中断；
• 项目上下文层：新建项目向导运行于“无项目上下文”状态，此时 项目级 Dart 支持开关（Enable Dart support）尚未生效，该设置仅影响已打开项目，与模板可见性无关——此为高频误区。

三、实操路径：适配 AS 2024.3.1 的七步安全恢复方案

1. 卸载现有 Flutter 插件（Settings → Plugins → 搜索 “Flutter” → 卸载）；
2. 关闭 AS，清空插件缓存：rm -rf ~/.AndroidStudio2024.3/system/plugins/（macOS/Linux）或 %USERPROFILE%\.AndroidStudio2024.3\system\plugins\（Windows）；
3. 重启 AS，在 Plugins 页面点击 ⚙️ Settings → Marketplace → 搜索 “Flutter”，确认安装 官方插件（Publisher: “Flutter Team”）且版本 ≥ v76.0.1；
4. 进入 Settings → Languages & Frameworks → Flutter，点击 “Flutter SDK path” 右侧 ⋯，精准选择解压后的 Flutter SDK 根目录（如 /opt/flutter 或 C:\src\flutter），必须包含 bin/flutter.bat（Win）或 bin/flutter（macOS/Linux）；
5. 点击 “Apply” → “OK”，此时 AS 将自动触发 SDK 验证与插件重初始化；
6. 执行 File → Close Project，返回欢迎页（Welcome Screen）——关键重启时机：必须在此界面操作新建项目，而非在已有项目中 File → New → Project；
7. 点击 New Project，在左侧模板分类中展开 “Mobile” → 查看是否出现 “Flutter Application”、“Flutter Package”、“Flutter Plugin” 等选项。

四、关键验证表：兼容性与配置黄金检查点

检查项	合规值（AS 2024.3.1）	验证方式	风险等级
Flutter 插件版本	≥ v76.0.1（2024年10月后发布）	Plugins 页面查看 Version 字段	🔴 高（不匹配则模板永不出现）
Flutter SDK 路径有效性	可执行 flutter --version 返回 3.22+ 且无报错	终端中 cd 到 SDK 目录后执行	🟠 中（路径错误导致插件初始化失败）
Dart 插件状态	必须启用（但单独启用无效）	Plugins 页面勾选 “Dart”	🟡 低（依赖项，非直接原因）
AS 运行模式	全新 Welcome Screen（非已打开项目内新建）	观察顶部菜单栏是否含 “Welcome to Android Studio”	🔴 高（误在项目内新建将跳过模板注册上下文）

五、防坑指南：五大常见误区与正解对照

graph TD
  A[误区：只装 Dart 插件] --> B[正解：Dart + Flutter 插件双启用]
  C[误区：用 GitHub 非官方分支插件] --> D[正解：仅从 JetBrains Marketplace 安装]
  E[误区：SDK 路径设为 flutter/bin] --> F[正解：设为 flutter 根目录]
  G[误区：在项目内 File→New→Project] --> H[正解：关闭所有项目，从 Welcome Screen 新建]
  I[误区：修改 dart.support.enable 项目设置] --> J[正解：该设置与模板注册完全无关]

六、进阶验证：命令行交叉校验与日志溯源

若上述步骤仍失败，执行以下诊断：

1. 在终端运行：flutter doctor -v，确认 [✓] Android toolchain 和 [✓] Chrome 均通过，且无 Missing plugin 提示；
2. 启动 AS 时添加 JVM 参数：-Didea.log.debug.categories=#com.jetbrains.flutter（Help → Edit Custom VM Options），重启后查看 ~/.AndroidStudio2024.3/system/log/idea.log，搜索 FlutterProjectTemplateProvider 或 registerTemplates 关键字，确认是否调用成功；
3. 终极兜底：使用 CLI 创建项目后导入：flutter create --platforms=android,ios my_app && open my_app（macOS）或 start my_app（Windows），再在 AS 中 File → Open 导入，虽绕过模板，但验证 SDK 与插件功能完整性。

```