Project IDX环境中Flutter生成式AI示例launch.json配置API_KEY失效求助

• 检查launch.json配置格式与环境变量引用
  在Project IDX中，需将--dart-define参数放在launch.json的args数组中。如果用环境变量传递密钥，先在Project IDX的Settings -> Environment Variables中添加GOOGLE_API_KEY并填入Gemini API密钥，保存后重启编辑器。示例配置如下：

  {
    "version": "0.2.0",
    "configurations": [
      {
        "name": "Flutter",
        "request": "launch",
        "type": "dart",
        "args": [
          "--dart-define=API_KEY=${env:GOOGLE_API_KEY}"
        ]
      }
    ]
  }
  

  也可直接写入密钥（不推荐，避免泄露）：

  "args": [
    "--dart-define=API_KEY=your-gemini-api-key-here"
  ]
  

• 验证代码中变量读取逻辑
  确保Flutter代码中正确读取变量，注意变量名大小写完全匹配：

  final apiKey = String.fromEnvironment('API_KEY', defaultValue: '');
  

  若变量名拼写错误（比如写成api_key），会导致读取失败。

• 清理缓存并重启调试
  缓存可能导致配置不生效，执行以下命令后重新启动调试：

  flutter clean
  flutter pub get
  

  关闭当前调试会话，重新点击调试按钮启动应用。

• 添加调试模式指定（可选）
  明确指定Flutter运行模式可解决部分兼容问题，在launch.json中添加flutterMode字段：

  {
    "name": "Flutter",
    "request": "launch",
    "type": "dart",
    "flutterMode": "debug",
    "args": [
      "--dart-define=API_KEY=${env:GOOGLE_API_KEY}"
    ]
  }
  

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