.NET MAUI中XAML无法识别TextBox组件的排查求助

首先明确：.NET MAUI不原生支持WPF/UWP的TextBox和TextBlock组件，你需要替换为MAUI专为跨平台设计的对应组件：

• 可编辑文本输入用Entry（对应原TextBox）
• 静态文本显示用Label（对应原TextBlock）

直接解决步骤：替换组件 #

将XAML中的错误组件替换为MAUI原生组件，示例如下：

<!-- 错误写法（WPF/UWP组件） -->
<!-- <TextBox Text="请输入内容" /> -->
<!-- <TextBlock Text="这是一段文本" /> -->

<!-- 正确写法（MAUI组件） -->
<Entry Placeholder="请输入内容" Text="默认文本" />
<Label Text="这是一段文本" FontSize="16" TextColor="#333" />

其他排查方案（替换后仍有问题时） #

• 清理重建项目：在Visual Studio中执行「生成」→「清理解决方案」，再「生成解决方案」；或终端运行：

  dotnet clean && dotnet build
  

• 检查项目配置：打开.csproj文件，确认已正确引入MAUI SDK，关键配置如下：

  <PropertyGroup>
      <TargetFrameworks>net8.0-android;net8.0-ios;net8.0-maccatalyst</TargetFrameworks>
      <UseMaui>true</UseMaui>
      <SingleProject>true</SingleProject>
  </PropertyGroup>
  

• 重置MAUI工作负载：终端执行以下命令后重启Visual Studio：

  dotnet workload uninstall maui
  dotnet workload install maui
  

• 移除错误命名空间：确保XAML中没有引入WPF/UWP相关的命名空间，你当前的命名空间配置是正确的。

关于兼容旧控件（不推荐） #

如果必须使用TextBox/TextBlock，可以尝试引入MAUI兼容性包Microsoft.Maui.Controls.Compatibility，但这会增加项目复杂度，且跨平台适配可能出现问题，仅建议用于迁移旧项目场景。

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