MAUI中使用DevExpress DXStackLayout遇引用错误求助

核心问题排查步骤 #

• 确认NuGet包安装完整
  必须安装DevExpress.Maui.Core和DevExpress.Maui.Layouts两个包（DXStackLayout属于Layouts库）。打开NuGet包管理器搜索并安装这两个包，确保版本与你的MAUI项目版本兼容。如果安装后仍报错，清理NuGet缓存后重新安装。

• 修正MauiProgram.cs配置
  必须在CreateMauiApp方法中调用UseDevExpress()扩展方法，且要放在Build()之前，示例代码：

  var builder = MauiApp.CreateBuilder();
  builder
      .UseMauiApp<App>()
      .UseDevExpress() // 这行是关键，不能漏
      .ConfigureFonts(fonts =>
      {
          fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
      });
  return builder.Build();
  

  如果提示MauiAppBuilder不存在UseDevExpress方法，大概率是NuGet包未正确安装或项目未引用到包，尝试卸载后重新安装。

• 修正XAML命名空间
  页面根元素的DevExpress命名空间必须指向正确的程序集，DXStackLayout的命名空间是DevExpress.Maui.Layouts，对应的程序集也是这个，正确写法：

  <ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
               xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
               xmlns:dx="clr-namespace:DevExpress.Maui.Layouts;assembly=DevExpress.Maui.Layouts"
               x:Class="YourAppName.MainPage">
      <dx:DXStackLayout>
          <!-- 你的布局内容 -->
      </dx:DXStackLayout>
  </ContentPage>
  

  很多新手会错误引用DevExpress.Maui.Core的命名空间，导致找不到DXStackLayout类型。

• 清理重建项目
  做完以上配置后，删除项目的bin和obj文件夹，重启Visual Studio后重新编译，避免缓存导致的错误。

错误示例与修正对比 #

错误的XAML（命名空间错误） #

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:dx="clr-namespace:DevExpress.Maui.Core;assembly=DevExpress.Maui.Core"
             x:Class="YourAppName.MainPage">
    <dx:DXStackLayout>
        <Label Text="测试文本" />
    </dx:DXStackLayout>
</ContentPage>

正确的XAML #

<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             xmlns:dx="clr-namespace:DevExpress.Maui.Layouts;assembly=DevExpress.Maui.Layouts"
             x:Class="YourAppName.MainPage">
    <dx:DXStackLayout>
        <Label Text="测试文本" />
    </dx:DXStackLayout>
</ContentPage>

错误的MauiProgram.cs（缺少UseDevExpress） #

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .ConfigureFonts(fonts =>
    {
        fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
    });
return builder.Build();

正确的MauiProgram.cs #

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseDevExpress()
    .ConfigureFonts(fonts =>
    {
        fonts.AddFont("OpenSans-Regular.ttf", "OpenSansRegular");
    });
return builder.Build();

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