XAML绑定在Release模式失效但Debug正常：CarouselView的FileName绑定异常

该问题是MAUI Release模式默认开启的程序集修剪（Trimming）+ AOT编译导致的：

• Debug模式默认关闭修剪，所有类型、属性都会完整保留，XAML通过反射实现的绑定可正常访问FileResult.FileName。
• Release模式默认开启全量修剪，静态编译分析阶段识别不到XAML中Binding标记对FileResult.FileName的反射调用，会判定该属性无实际引用、直接裁剪移除。
• 你遇到的FullPath绑定正常，是因为MAUI的图片加载底层逻辑会静态引用FileResult.FullPath，没有被裁剪器移除。

按推荐优先级排序如下：

方案1：自定义绑定包装类（最优） #

不要直接绑定FileResult实体，新建带强类型的包装类，在后台代码中显式读取FileResult的属性，让编译阶段能识别到引用，同时避免后续升级MAUI版本出现不可控的裁剪问题。

• 新建包装类：

public class FilePreviewItem
{
    public string FileName { get; set; }
    public string FullPath { get; set; }

    public FilePreviewItem(FileResult sourceFile)
    {
        FileName = sourceFile.FileName;
        FullPath = sourceFile.FullPath;
    }
}

• 修改后台代码的属性定义与赋值逻辑：

// 原有代码
private IEnumerable<FileResult> pickedFiles;
public IEnumerable<FileResult> Files { get => pickedFiles; }

// 修改为
private IEnumerable<FilePreviewItem> previewFiles;
public IEnumerable<FilePreviewItem> Files { get => previewFiles; }

// 构造函数中替换原有赋值逻辑
public FileView(IEnumerable<FileResult> pF)
{
    InitializeComponent();
    SelectedTime = "1";
    // 原有 pickedFiles = pF; 替换为以下代码
    previewFiles = pF.Select(file => new FilePreviewItem(file)).ToList();
    BindingContext = this;
}

• 现有XAML代码不需要做任何调整，绑定逻辑完全兼容。

方案2：显式标记需保留的属性 #

如果不想修改现有类结构，可以通过DynamicDependency特性显式告诉裁剪器要保留FileResult的属性：

• 先引入命名空间：

using System.Runtime.CompilerServices;

• 在FileView类上方添加特性：

[DynamicDependency(nameof(FileResult.FileName), typeof(FileResult))]
[DynamicDependency(nameof(FileResult.FullPath), typeof(FileResult))]
[XamlCompilation(XamlCompilationOptions.Compile)]
public partial class FileView : ContentPage

• 该特性会在修剪阶段强制保留指定属性，避免被裁剪移除。

方案3：临时关闭程序集修剪 #

如果不需要严格优化安装包体积，可以直接关闭Release模式的修剪，编辑项目的.csproj文件，在<PropertyGroup>节点添加：

<IsTrimmable>false</IsTrimmable>

• 该方案会显著增加安装包体积，仅适合临时调试验证，不推荐生产发布使用。

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