构建Flutter应用时如何在终端/CMD传递多个参数及参数不生效排查

正确多参数传递规则 #

Flutter 构建命令的参数分为两类，多参数传递时需按分类做区分：

• 第一类是 Flutter 构建命令原生支持的参数，比如你用到的--split-debug-info，可以直接跟在flutter build apk后面
• 第二类是需要透传给 Dart 编译器的参数，比如--no-sound-null-safety，这类参数必须放在分隔符--之后，否则会被 Flutter 识别为无效参数直接忽略

你遇到的参数不生效问题，核心原因就是把 Dart 编译参数直接跟在了 Flutter 构建参数后面，没有添加分隔符。正确的命令写法如下：
flutter build apk --split-debug-info -- --no-sound-null-safety

参数不生效通用排查步骤 #

• 首先核对参数所属分类：确认目标参数是 Flutter 原生构建参数还是 Dart 编译参数，后者必须添加--分隔符透传
• 执行构建命令时添加-v参数开启 verbose 日志，在输出日志中检索最终传递给 Dart 编译器的参数列表，确认目标参数是否被正确传入
• 检查项目本地配置：确认pubspec.yaml、Android 目录下的build.gradle、iOS 目录下的Podfile等配置文件中，是否存在强制覆盖空安全配置的规则，本地配置优先级高于命令行参数
• 核对 Flutter 版本兼容性：部分低版本 Flutter 存在透传参数识别异常的bug，可升级到最新稳定版后重试

内容的提问来源于stack exchange，提问作者Mohamed Ayman