Flutter dart-define首次构建不生效，仅热重启后生效问题求助

问题概述 #

使用Flutter 3.7.10版本配置多环境Flavor时，首次启动应用通过String.fromEnvironment无法获取正确的Flavor标识，仅在执行Hot Restart后才能拿到预期值。

环境信息 #

[✓] Flutter (Channel stable, 3.7.10, on macOS 13.3.1 22E772610a darwin-arm64, locale en-VN)
    • Flutter version 3.7.10 on channel stable at /Users/tungakanui/fvm/versions/3.7.10
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision 4b12645012 (3 months ago), 2023-04-03 17:46:48 -0700
    • Engine revision ec975089ac
    • Dart version 2.19.6
    • DevTools version 2.20.1

[!] Android toolchain - develop for Android devices (Android SDK version 33.0.0)
    • Android SDK at /Users/tungakanui/Library/Android/sdk
    • Platform android-33, build-tools 33.0.0
    • Java binary at: /Applications/Android Studio.app/Contents/jre/Contents/Home/bin/java
    • Java version OpenJDK Runtime Environment (build 11.0.12+0-b1504.28-7817840)
    ! Some Android licenses not accepted. To resolve this, run: flutter doctor --android-licenses

[✓] Xcode - develop for iOS and macOS (Xcode 14.3.1)
    • Xcode at /Applications/Xcode.app/Contents/Developer
    • Build 14E300c
    • CocoaPods version 1.12.1

[✓] Chrome - develop for the web
    • Chrome at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

[✓] Android Studio (version 2021.2)
    • Android Studio at /Applications/Android Studio.app/Contents
    • 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 11.0.12+0-b1504.28-7817840)

[✓] VS Code (version 1.79.2)
    • VS Code at /Applications/Visual Studio Code.app/Contents
    • Flutter extension version 3.64.0

[✓] Connected device (3 available)
    • iPhone 14 Pro (mobile) • BF0C1972-F6B0-4164-BDBF-59D6BCF6B117 • ios            • com.apple.CoreSimulator.SimRuntime.iOS-16-4 (simulator)
    • macOS (desktop)        • macos                                • darwin-arm64   • macOS 13.3.1 22E772610a darwin-arm64
    • Chrome (web)           • chrome                               • web-javascript • Google Chrome 114.0.5735.198

[✓] HTTP Host Availability
    • All required HTTP hosts are available

! Doctor found issues in 1 category.

关键配置说明 #

• main.dart：通过const String.fromEnvironment('FLAVOR', defaultValue: 'dev')获取Flavor标识
• IDE配置：VS Code的launch.json中配置了Flavor对应的启动参数
• 首次启动结果：应用显示默认值dev，而非目标Flavor值
• iOS配置：project.pbxproj中已添加Flavor对应的Scheme配置

解决方案 #

1. 确保编译期参数正确传递 #

String.fromEnvironment是编译期常量，必须在构建阶段传递--dart-define参数，而非仅在Hot Restart时生效：

• 检查VS Code的launch.json配置，确保args中同时包含--flavor和--dart-define参数：

  {
    "version": "0.2.0",
    "configurations": [
      {
        "name": "Flavor - Production",
        "request": "launch",
        "type": "dart",
        "args": [
          "--flavor", "prod",
          "--dart-define=FLAVOR=prod"
        ]
      }
    ]
  }
  

• 用命令行手动构建验证，排除IDE配置问题：

  flutter run --flavor prod --dart-define=FLAVOR=prod
  

2. 修复iOS Scheme的Build Configuration #

在Xcode中为每个Flavor对应的Scheme配置添加编译参数：

1. 打开Xcode，选择目标Scheme → 点击Edit Scheme
2. 切换到Run → Arguments标签
3. 在Other Flutter Flags中添加--dart-define=FLAVOR=prod（替换为对应Flavor值）
4. 确保Build Configuration选择对应Flavor的配置（如Release-prod）

3. 清理构建缓存 #

旧缓存可能导致参数未更新，执行以下命令清理后重新构建：

flutter clean
flutter pub get
flutter run --flavor prod --dart-define=FLAVOR=prod

4. 移除不必要的const修饰（可选） #

如果const修饰导致编译期提前锁定默认值，可尝试改为final：

final String flavor = String.fromEnvironment('FLAVOR', defaultValue: 'dev');

注：此方法为临时 workaround，优先保证参数传递正确是根本解决方式。

内容的提问来源于stack exchange，提问作者Tùng Ng Thanh