Flutter中Image.asset显示异常：Logo不显示且宽高设置无效求助

问题重现 #

使用Image.asset加载自定义Logo时无法正常显示，相关代码：

leading: Image.asset(
    "assets/icons/belha-logo.jpg",
    fit: BoxFit.cover,
    height: 40,
    width: 40,
),

已尝试调整width、height及fit属性，问题仍存在。

排查与解决步骤 #

• 验证资源路径与配置

  1. 确认项目中assets/icons/belha-logo.jpg文件真实存在，注意路径大小写（Flutter对路径大小写敏感，iOS/macOS环境尤其严格）。
  2. 检查pubspec.yaml的资源配置是否正确，需包含该图片所在目录或具体文件：

     flutter:
       assets:
         - assets/icons/
     

  3. 修改配置后执行flutter pub get刷新资源索引。

• 清除缓存重建项目

  1. 执行flutter clean清除项目缓存，再重新运行flutter run。
  2. 若为iOS环境，可卸载App后重装，或删除Xcode的Derived Data后重新编译。

• 检查图片文件有效性

  1. 用图片查看器打开belha-logo.jpg，确认文件未损坏、格式正常。
  2. 尝试将图片转换为PNG格式后重新测试，部分环境对JPG格式的兼容性存在差异。

• 排查父组件约束问题

  1. 将Image.asset单独放到空白页面测试，确认图片本身可正常加载：

     Scaffold(
       body: Center(
         child: Image.asset("assets/icons/belha-logo.jpg", height: 40, width: 40),
       ),
     )
     

  2. 若单独加载正常，说明问题出在leading所在的父组件（如AppBar）的约束，可尝试用Container包裹并调整内边距：

     leading: Container(
       padding: EdgeInsets.symmetric(horizontal: 8, vertical: 8),
       child: Image.asset(
         "assets/icons/belha-logo.jpg",
         fit: BoxFit.cover,
         height: 40,
         width: 40,
       ),
     )
     

内容的提问来源于stack exchange，提问作者Fatih Yılmaz