Flutter iOS端构建时Build flavors始终默认使用Xcode命令行默认值如何解决

问题根因 #

安卓端配置正常说明Flutter层的flavor定义无误，问题出在iOS侧Xcode的Scheme、Build Configuration与Flutter flavor的映射规则不匹配，导致Flutter命令的flavor参数无法正确传递到Xcode构建流程。

修复步骤 #

1. 匹配Xcode Scheme与flavor命名 #

• 打开项目下的ios/Runner.xcworkspace（请勿直接打开.xcodeproj文件）
• 点击顶部菜单栏Runner > Manage Schemes，确认存在与--flavor参数值完全一致的Scheme（大小写、拼写完全相同，比如命令用--flavor dev就必须有名为dev的Scheme）
• 选中对应Scheme点击「Edit」，分别检查左侧Run、Test、Profile、Archive、Analyze五个构建场景，右侧的Build Configuration要选择对应flavor的配置：例如dev Scheme的Run场景选Debug-dev，Archive场景选Release-dev，staging Scheme同理对应Debug-staging/Release-staging，不要全部使用默认的Debug/Release配置。

2. 校验xcconfig配置 #

• 打开ios/Flutter目录下的Flutter.xcconfig、Generated.xcconfig，确认没有硬编码覆盖CONFIGURATION、FLUTTER_BUILD_MODE等全局变量
• 如果你自定义了xcconfig文件，可在对应flavor的xcconfig中添加配置绑定：

  // dev环境xcconfig添加
  FLAVOR = dev
  // staging环境xcconfig添加
  FLAVOR = staging
  

3. 补充构建命令的configuration参数 #

Flutter iOS构建需要同时指定flavor和对应的Xcode Build Configuration名称，命令示例如下：

# dev环境构建
flutter build ios -t lib/main.dev.dart --flavor dev --configuration "Debug-dev"
# staging环境构建
flutter build ios -t lib/main.staging.dart --flavor staging --configuration "Release-staging"

--configuration后的参数值必须和Xcode中你配置的Build Configuration名称完全一致，包含空格、大小写。

4. 清理缓存重试 #

如果配置修改后仍不生效，执行以下命令清理缓存后重试：

flutter clean
rm -rf ios/Flutter/Flutter.framework
rm -rf ios/Pods
rm ios/Podfile.lock
cd ios && pod install && cd ..

额外校验项 #

如果上述步骤都执行后仍有问题，检查Xcode命令行工具版本是否匹配：

• 执行xcode-select -p查看当前绑定的Xcode路径
• 如果路径错误，执行sudo xcode-select -s /Applications/Xcode.app/Contents/Developer修改为正式版Xcode的路径

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