MAUI内容页Compiled Binding（编译绑定）配置故障求助

出现App.g.i.cs相关报错，通常是编译绑定的强类型检查未通过，或是项目配置、代码存在疏漏，以下是常见问题及修复步骤：

1. 验证命名空间与ViewModel的可访问性 #

• 检查XAML根元素的命名空间声明，确保viewmodel前缀对应的命名空间和MainViewModel所在的实际命名空间完全匹配（MAUI对命名空间大小写敏感）：

  <ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
               xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
               xmlns:viewmodel="clr-namespace:YourAppNamespace.ViewModels" <!-- 替换为你的实际命名空间 -->
               x:Class="YourAppNamespace.MainPage"
               x:DataType="viewmodel:MainViewModel">
  

• 确认MainViewModel是公共类（public），且自身无编译错误（比如未实现的接口、语法错误等），ViewModel编译失败会直接导致绑定生成代码报错。

2. 确认编译绑定配置已开启 #

MAUI默认可能未全局启用编译绑定，需要在项目文件（.csproj）中添加以下配置：

<PropertyGroup>
  <UseCompiledBindings>true</UseCompiledBindings>
</PropertyGroup>

如果仅需在当前页面启用，也可在XAML根元素添加x:CompileBindings="True"。

3. 检查BindingContext的赋值时机 #

确保BindingContext在InitializeComponent()之后赋值，避免初始化XAML时找不到ViewModel类型：

public MainPage()
{
    InitializeComponent();
    BindingContext = new MainViewModel(); // 必须放在InitializeComponent之后
}

如果使用依赖注入，确认DI容器已正确注册MainViewModel，且构造函数能正常获取实例。

4. 校验绑定属性的正确性 #

编译绑定是强类型检查，需确保XAML中所有绑定的属性在ViewModel中存在且符合要求：

• 绑定的属性必须是公共属性（public），名称拼写、大小写完全一致；
• 命令绑定需确保是ICommand类型的公共属性（比如public ICommand SubmitCommand { get; }）。

5. 清理重建项目 #

缓存问题也可能导致生成代码报错，执行以下操作：

• 右键项目选择「清理」；
• 删除项目目录下的bin和obj文件夹；
• 重新生成并运行项目。

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