.NET MAUI跨开发机无法以Windows Machine运行的问题求助

这类问题通常源于项目Windows平台配置丢失、依赖未正确恢复，或是本地SDK组件缺失，以下是具体解决方法：

1. 检查并修复项目文件的Windows目标配置 #

打开MAUI项目的.csproj文件，确认包含Windows平台的完整配置，确保以下节点存在且正确：

<PropertyGroup>
    <!-- 确保包含Windows目标框架 -->
    <TargetFrameworks>net6.0-android;net6.0-ios;net6.0-maccatalyst;net6.0-windows10.0.19041.0</TargetFrameworks>
    <WindowsPackageType>MSIX</WindowsPackageType>
    <UseWinUI>true</UseWinUI>
    <Platforms>AnyCPU;x64;x86;ARM64</Platforms>
</PropertyGroup>

<ItemGroup Condition="$(TargetFramework.Contains('-windows'))">
    <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.1.5" />
    <PackageReference Include="Microsoft.UI.Xaml" Version="2.8.1" />
</ItemGroup>

若配置缺失，手动添加后保存并重新加载项目。

2. 清理并恢复项目依赖 #

按以下步骤操作：

• 右键项目选择清理
• 右键项目选择恢复NuGet包
• 关闭Visual Studio，删除项目目录下的bin、obj文件夹及.vs隐藏文件夹
• 重新打开项目，尝试构建

3. 验证Windows SDK组件安装 #

两台机器都需确认MAUI开发所需的Windows组件已安装：

• 打开Visual Studio安装器，选择修改当前VS2022安装
• 确保勾选**.NET Multi-platform App UI开发工作负载，且该负载下的Windows SDK (10.0.19041.0)**（对应项目目标版本）已勾选
• 若缺失，点击修改完成安装后重启VS

4. 修正Git忽略规则 #

确保.gitignore包含MAUI项目的正确忽略项，避免提交本地生成文件：

# MAUI本地生成文件
/bin/
/obj/
.vs/
*.user
*.suo
# Windows平台专属生成文件
/Platforms/Windows/AppPackages/
# 模板字体文件（通过NuGet恢复，无需提交）
OpenSans-Regular.ttf
OpenSans-Semibold.ttf

若之前误提交了这些文件，先从Git中移除，更新.gitignore后重新提交。

5. 重置调试配置 #

若仍无"Windows Machine"选项：

• 打开调试 -> 调试和启动设置
• 删除现有启动配置，点击添加 -> .NET MAUI，选择Windows平台配置
• 保存后重启VS，查看选项是否恢复

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