使用Rider开发Xamarin.iOS遇图片集消失、按钮加载图片失效问题

你遇到的所有异常本质是跨Rider/Xcode编辑资产导致的资源打包失效、iOS资源引用规则不匹配两个核心问题，没有代码逻辑层面的硬错误。

核心问题原因 #

• 资产丢失问题：Xamarin.iOS项目默认由Rider的MSBuild体系管理资源打包流程，直接用Xcode打开项目内的Assets.xcassets编辑时，Xcode没有和Rider的项目文件建立持久化写入关联，拖入的图片集仅写入Xcode临时缓存，退出Xcode后临时内容被清理，自然看不到之前创建的图片集，Rider控制台的报错也正是因为资产写入不完整，资产编译器找不到对应图片条目。
• 图片加载为空：iOS对资源名大小写敏感，如果你创建的图片集名称和代码里传入的checked/unchecked大小写不一致，或者图片没有被正确设置为BundleResource生成动作，UIImage.FromBundle会直接返回null，自然加载不出图片。
• 按钮图片不显示：直接修改ImageView.Image的方式不符合UIButton的设计逻辑，UIButton的图片是按状态（Normal/Highlighted/Selected）单独管理的，手动修改ImageView的内容会被按钮的状态配置覆盖，哪怕图片加载成功也会显示空白。

分步解决方法 #

1. 修复Assets.xcassets的编辑流程 #

• 完全不要用Xcode打开项目内的Assets.xcassets编辑，所有资产操作直接在Rider内完成
• 在Rider的xcassets编辑器中右键新建Image Set，命名严格为checked、unchecked，和代码里的字符串完全大小写一致
• 分别将对应1x/2x/3x分辨率的PNG文件拖入图片集的对应槽位，不要仅拖入单个分辨率的图片

2. 清理缓存并校验资源打包配置 #

• 删除项目根目录下的bin、obj文件夹，同时清除iOS模拟器内对应应用的缓存，避免旧的空资源包被缓存
• 打开项目的.csproj文件，确认Assets.xcassets的打包配置存在，图片文件的生成动作为BundleResource
• 在Rider的项目属性→iOS Build标签下，确认资产编译选项为开启状态

3. 修正代码逻辑 #

不要在单元格构造函数中加载图片（构造函数执行时资源包可能未完全初始化），同时修正按钮图片设置逻辑：

// 懒加载图片，避免构造函数加载时序问题
private UIImage _checkedImage;
private UIImage _uncheckedImage;
private UIImage CheckedImage => _checkedImage ??= UIImage.FromBundle("checked") 
    ?? throw new InvalidOperationException("checked图片未正确打包到Bundle");
private UIImage UncheckedImage => _uncheckedImage ??= UIImage.FromBundle("unchecked") 
    ?? throw new InvalidOperationException("unchecked图片未正确打包到Bundle");

替换原有AdjustImage方法的实现，统一用SetImage设置按钮分状态图片：

void AdjustImage() {
    UIImage targetImage = listItem.CurrentCheckedState switch {
        CheckedState.Checked => CheckedImage,
        CheckedState.NotChecked => UncheckedImage,
        _ => throw new ArgumentOutOfRangeException()
    };
    // 必须指定Normal状态，否则默认状态下图片不会生效
    ListItemCheckbox.SetImage(targetImage, UIControlState.Normal);
    // 若按钮同时绑定了标题，需要调整图片内边距，避免图片被标题挤出可视区域
    ListItemCheckbox.ImageEdgeInsets = new UIEdgeInsets(0, -8, 0, 8);
}

• 额外校验：确认按钮的Frame尺寸不小于44x44pt，尺寸过小会导致图片被裁剪不可见

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