为Flutter浮动按钮添加图片时运行报错求助

问题场景 #

为SpeedDial浮动按钮的子项添加本地图片时出现报错，相关代码如下：

//Floating button
floatingActionButton: SpeedDial(
  //button size
  buttonSize: const Size(70, 70),
  // color
  backgroundColor: Color.fromRGBO(255, 114, 94, 1),
  child: Icon(Icons.add),
  children: [
    SpeedDialChild( //speed dial child
      child: Image.asset("test.png", fit: BoxFit.fitWidth,),
    ),
  ],
),

常见报错原因及解决步骤 #

• 资源未在pubspec.yaml中配置
  确保在项目的pubspec.yaml文件中正确声明图片资源，示例：

  flutter:
    assets:
      - assets/test.png # 若图片放在assets目录下
      # 若图片在根目录则写 - test.png
  

  注意缩进要符合YAML格式要求（通常用2个空格）。

• 图片路径错误
  确认Image.asset的路径与实际文件位置一致：

  • 若图片存放在项目根目录的assets文件夹中，路径应为"assets/test.png"
  • 文件名区分大小写，需保证代码中的文件名与实际文件完全一致（如Test.png和test.png会被视为不同文件）

• 缓存导致资源未加载
  执行以下命令清理缓存并重启项目：

  flutter clean
  flutter run
  

• 布局尺寸问题
  为Image.asset指定明确的宽高，避免因尺寸适配报错：

  child: Image.asset(
    "assets/test.png",
    fit: BoxFit.fitWidth,
    width: 24,
    height: 24,
  ),
  

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