Avalonia ReactiveUI的RoutedViewHost无法正确加载对应视图

算力阿峰

2026-9-24

问题解决方案

你遇到的问题核心是`RoutedViewHost`未正确关联Avalonia MVVM模板自带的`ViewLocator`，或缺少ReactiveUI服务注册，按以下步骤排查修改即可：

第一步：检查Program.cs中是否注册ReactiveUI服务
必须在应用构建逻辑中添加UseReactiveUI()调用，示例代码：

public static AppBuilder BuildAvaloniaApp()
    => AppBuilder.Configure<App>()
        .UsePlatformDetect()
        .UseReactiveUI() // 新增这行注册ReactiveUI服务
        .LogToTrace();

第二步：确认App.axaml中已声明全局ViewLocator
确保应用全局数据模板中包含你的ViewLocator，示例代码：

<Application 
    xmlns="https://github.com/avaloniaui"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="using:GuiClient"
    x:Class="GuiClient.App">
    <Application.DataTemplates>
        <local:ViewLocator />
    </Application.DataTemplates>
</Application>

第三步：为RoutedViewHost显式指定ViewLocator
你当前的RoutedViewHost未绑定视图定位器，补充ViewLocator属性绑定即可：

<rxui:RoutedViewHost Grid.Row="0" 
                     Router="{Binding Router}" 
                     PageTransition="{x:Null}"
                     ViewLocator="{StaticResource ViewLocator}">
    <rxui:RoutedViewHost.DefaultContent>
        <TextBlock Text="Main Window"
                   HorizontalAlignment="Center"
                   VerticalAlignment="Center" />
    </rxui:RoutedViewHost.DefaultContent>
</rxui:RoutedViewHost>