Flutter VSCode使用Flavors时，如何配置安装对应环境的APK？

云原生阿岚

2026-8-3

解决VSCode中Flutter Flavor安装对应APK的问题

1. 配置VSCode调试配置文件（launch.json）

打开项目根目录下的.vscode/launch.json文件（若不存在则直接新建），在configurations数组中添加或修改针对UAT环境的调试配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Flutter (UAT)",
            "request": "launch",
            "type": "dart",
            "flutterMode": "debug",
            "args": [
                "--flavor", "uat",
                "--target", "lib/main_uat.dart" // 根据你的UAT入口文件路径修改
            ]
        },
        {
            "name": "Flutter (Production)",
            "request": "launch",
            "type": "dart",
            "flutterMode": "debug",
            "args": [
                "--flavor", "production",
                "--target", "lib/main_production.dart" // 对应Production入口文件路径
            ]
        }
    ]
}

核心是通过args传递--flavor参数，让Flutter CLI明确识别要使用的环境，从而构建并安装对应后缀的APK。

2. 验证调试启动方式

在VSCode左侧调试面板中，选择Flutter (UAT)配置启动调试。此时VSCode会调用带flavor参数的Flutter命令，自动生成并安装app-uat-debug.apk。

如果手动构建，也要使用带flavor的命令：

flutter build apk --flavor uat --debug

3. 确认Android端Flavor基础配置

检查android/app/build.gradle中的flavor配置是否正确，示例如下：

flavorDimensions "environment"
productFlavors {
    uat {
        dimension "environment"
        applicationIdSuffix ".uat"
        versionNameSuffix "-uat"
    }
    production {
        dimension "environment"
    }
}

这是Flutter能生成带flavor后缀APK的基础配置，确保没有遗漏。