UWP中Prism Auto ViewModelLocator子目录视图模型注入异常问题

我之前也遇到过Prism在UWP子目录下视图模型匹配失败、 fallback到ShellViewModel的问题，结合Windows Template Studio + Prism 6.3的特性，给你几个针对性的解决方案：

1. 先检查命名空间与类名的匹配性 #

Prism默认的ViewModelLocator是靠命名空间对应+类名后缀来自动关联视图和视图模型的，这是最容易出错的点：

• 确保SalesListPage的命名空间是你的项目名.Views.子目录名（比如MyUwpApp.Views.Sales）
• 对应的SalesListViewModel命名空间必须是你的项目名.ViewModels.子目录名（比如MyUwpApp.ViewModels.Sales）
• 类名严格遵循XXXPage对应XXXViewModel的规则，不能有拼写错误

如果命名空间结构不对，Prism找不到对应的ViewModel，就会自动使用默认的ShellViewModel作为DataContext，这就是你遇到绑定报错的原因。

2. 自定义ViewModelLocator的全局匹配规则 #

如果你的子目录结构比较复杂，默认规则覆盖不到，可以在App.xaml.cs里手动配置全局匹配逻辑，确保子目录的视图能正确找到对应的ViewModel：
在OnInitialize方法中添加以下代码：

protected override void OnInitialize()
{
    base.OnInitialize();
    // 自定义视图→视图模型的匹配规则，支持任意子目录结构
    ViewModelLocationProvider.SetDefaultViewTypeToViewModelTypeResolver(viewType =>
    {
        var viewFullName = viewType.FullName;
        // 替换Views为ViewModels，保留子目录层级，再加上Model后缀
        var viewModelFullName = viewFullName.Replace(".Views.", ".ViewModels.") + "Model";
        return Type.GetType(viewModelFullName);
    });
}

这个规则会自动把视图的命名空间里的.Views.替换成.ViewModels.，再给类名加上Model后缀，完美适配子目录结构。

3. 手动指定单个页面的ViewModel（快速解决单个页面问题） #

如果不想修改全局规则，也可以给SalesListPage手动绑定ViewModel：

方式一：XAML中开启自动绑定 #

在SalesListPage.xaml的根Page标签里添加Prism的自动绑定属性，确保命名空间正确：

<Page
    x:Class="MyUwpApp.Views.Sales.SalesListPage"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:prism="using:Prism.Windows.Mvvm"
    prism:ViewModelLocator.AutoWireViewModel="True">
    <!-- 页面内容 -->
</Page>

方式二：代码后台手动注入 #

先在App.xaml.cs的RegisterTypes方法里注册ViewModel：

protected override void RegisterTypes()
{
    // 注册SalesListViewModel到Prism容器
    Container.RegisterType<SalesListViewModel>();
}

然后在SalesListPage的构造函数里手动注入并设置DataContext：

public SalesListPage(SalesListViewModel viewModel)
{
    InitializeComponent();
    DataContext = viewModel;
}

4. 检查Windows Template Studio生成的导航配置 #

Windows Template Studio生成的Prism项目通常会有预设的导航规则，确保你是通过Prism的导航服务跳转到SalesListPage的，而不是直接实例化页面：
比如在ShellViewModel里使用导航：

private async void NavigateToSalesList()
{
    await NavigationService.NavigateAsync("SalesListPage");
}

直接实例化页面的话，Prism不会自动处理ViewModel的关联，容易导致DataContext错误。

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