如何向VS Code的Flutter Web调试会话传递命令行参数

1. 先修复launch.json的语法错误 #

你当前的launch.json存在多处语法问题，会直接导致配置不生效：

• configurations字段应为数组类型，你当前写为了对象类型，标准launch.json结构参考：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Flutter (Debug)",
      "request": "launch",
      "type": "dart",
      "env": {
        "DEBUG_MODE": "true"
      },
      "args": [
        "--dart-define",
        "DEBUG_VALUE=true"
      ]
    }
  ]
}

• 原有配置中env代码块末尾没有加逗号，和后续args字段之间缺少分隔符，同时args数组最后一个元素末尾多了冗余逗号，都会导致JSON解析失败。
• 配置修改完成后，需要在VS Code调试侧边栏的运行配置下拉框中选中你修改的对应配置，再点击启动，配置才会生效。

2. 区分编译时常量和系统环境变量的读取方式 #

• String.fromEnvironment/bool.fromEnvironment读取的仅为编译时通过--dart-define传递的常量，无法读取launch.json中env字段配置的系统环境变量。
  • 放在env中的DEBUG_MODE需要导入dart:io后用Platform.environment['DEBUG_MODE']读取，不能用fromEnvironment方法。
  • 通过--dart-define传递的DEBUG_VALUE才可以用fromEnvironment读取，注意修改参数后需要完全停止应用后重新冷启动，热重载/热重启不会更新编译时常量。
• 推荐直接用对应类型的fromEnvironment方法读取编译常量，避免类型转换：比如读取布尔值用bool.fromEnvironment('DEBUG_VALUE', defaultValue: false)。

3. main函数args为空的原因 #

launch.json中args字段传递的参数是给Flutter编译工具的，不是直接传递给应用的main函数，所以Flutter项目中main的args默认是空数组。如果你需要给应用层传参数，统一用--dart-define传递即可。

修复后的代码示例 #

import 'dart:io';

void main(List<String> args) {
  // 读取系统环境变量DEBUG_MODE
  final debugMode = Platform.environment['DEBUG_MODE'];
  // 读取编译时常量DEBUG_VALUE
  final debugValue = bool.fromEnvironment('DEBUG_VALUE', defaultValue: false);

  print('debugMode: $debugMode');
  print('debugValue: $debugValue');
}

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