执行flutter create未生成build.gradle等关键Gradle文件求助

快速排查与修复步骤 #

1. 确保操作目录干净 #

执行flutter create .前，确认当前目录没有残留的Flutter项目文件（比如之前创建过项目但未清理彻底）。如果有残留，先清空目录（保留需要的文件），或者切换到全新空目录重新执行：

flutter create .

2. 强制指定Android平台生成 #

用--platforms参数强制Flutter补全Android相关文件，执行：

flutter create --platforms android .

这个命令会优先生成/修复Android平台的项目结构，包含缺失的build.gradle和settings.gradle文件。

3. 检查Flutter环境完整性 #

执行以下命令排查环境配置问题：

flutter doctor

重点关注Android相关提示：

• 确认Android SDK已安装，且ANDROID_HOME环境变量配置正确
• 检查是否安装了Android SDK Command-line Tools（可在Android Studio的SDK Manager中找到）
• 按照提示修复所有未解决的问题后，再重新生成项目

4. 手动补全关键文件（安全模板） #

如果上述方法无效，可以手动创建以下文件，内容采用Flutter默认模板，避免配置错误：

根目录android/build.gradle

buildscript {
    ext.kotlin_version = '1.9.0'
    repositories {
        google()
        mavenCentral()
    }

    dependencies {
        classpath "com.android.tools.build:gradle:7.4.2"
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

rootProject.buildDir = '../build'
subprojects {
    project.buildDir = "${rootProject.buildDir}/${project.name}"
}
subprojects {
    project.evaluationDependsOn(':app')
}

tasks.register("clean", Delete) {
    delete rootProject.buildDir
}

根目录android/settings.gradle

pluginManagement {
    def flutterSdkPath = {
        def properties = new Properties()
        file("local.properties").withInputStream { properties.load(it) }
        def flutterSdkPath = properties.getProperty("flutter.sdk")
        assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
        return flutterSdkPath
    }()

    includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")

    repositories {
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}

plugins {
    id "dev.flutter.flutter-plugin-loader" version "1.0.0"
    id "com.android.application" version "7.4.2" apply false
    id "org.jetbrains.kotlin.android" version "1.9.0" apply false
}

include ":app"

android/app/build.gradle

def localProperties = new Properties()
def localPropertiesFile = rootProject.file('local.properties')
if (localPropertiesFile.exists()) {
    localPropertiesFile.withInputStream { stream ->
        localProperties.load(stream)
    }
}

def flutterRoot = localProperties.getProperty('flutter.sdk')
if (flutterRoot == null) {
    throw new GradleException("Flutter SDK not found. Define location with flutter.sdk in the local.properties file.")
}

def flutterVersionCode = localProperties.getProperty('flutter.versionCode')
if (flutterVersionCode == null) {
    flutterVersionCode = '1'
}

def flutterVersionName = localProperties.getProperty('flutter.versionName')
if (flutterVersionName == null) {
    flutterVersionName = '1.0'
}

apply plugin: 'com.android.application'
apply plugin: 'kotlin-android'
apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"

android {
    namespace "com.example.your_app_name"
    compileSdkVersion flutter.compileSdkVersion
    ndkVersion flutter.ndkVersion

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }

    kotlinOptions {
        jvmTarget = '1.8'
    }

    sourceSets {
        main.java.srcDirs += 'src/main/kotlin'
    }

    defaultConfig {
        applicationId "com.example.your_app_name"
        minSdkVersion flutter.minSdkVersion
        targetSdkVersion flutter.targetSdkVersion
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
    }

    buildTypes {
        release {
            signingConfig signingConfigs.debug
        }
    }
}

flutter {
    source '../..'
}

dependencies {
    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
}

注意：将上述文件中的com.example.your_app_name替换为你的项目包名（可与pubspec.yaml中的name对应）。

关于Master版本的说明 #

你使用的Flutter Master分支属于开发预览版，可能存在不稳定问题。如果后续遇到更多异常，可考虑切换到Beta分支（若所需热修复已包含在Beta版中），执行命令：

flutter channel beta
flutter upgrade

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