You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

升级至VS 17.8.3后MAUI项目无法运行,求解决方案

.NET6 MAUI迁移至.NET8(VS 2022 17.8.3)故障排查方案

1. 彻底清理并重装MAUI工作负载

先卸载所有关联工作负载,避免版本冲突:

dotnet workload uninstall maui maui-android maui-ios maui-maccatalyst maui-windows

清理.NET本地缓存:

dotnet nuget locals all --clear

重启VS后,指定版本重装MAUI工作负载(匹配你已确认的8.0.3版本):

dotnet workload install maui --from-rollback-file https://aka.ms/dotnet/maui/8.0.3/rollback.json

2. 修复项目.csproj配置(核心步骤)

  • 替换SDK引用:将项目顶部的<Project Sdk="Microsoft.NET.Sdk">改为<Project Sdk="Microsoft.NET.Sdk.Maui">,这是MAUI项目的标准SDK,手动添加Microsoft.Maui.Controls会导致版本冲突,需删除单独的该包引用。
  • 统一目标框架配置:确保PropertyGroup块包含正确的.NET8目标框架,示例如下:
<PropertyGroup>
  <TargetFrameworks>net8.0-android;net8.0-ios;net8.0-maccatalyst;net8.0-windows10.0.19041.0</TargetFrameworks>
  <TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('windows'))">$(TargetFrameworks);net8.0-windows10.0.22621.0</TargetFrameworks>
  <UseMaui>true</UseMaui>
  <SingleProject>true</SingleProject>
  <ImplicitUsings>enable</ImplicitUsings>
  <Nullable>enable</Nullable>
</PropertyGroup>
  • 检查Windows端入口:确认Windows平台的App.xaml.cs继承正确,应为public partial class App : MauiWinUIApplication<App>,且命名空间无拼写错误。

3. 修复VS项目属性异常

  • 关闭VS,删除项目目录下的.vs、bin、obj文件夹,清理缓存
  • 重新打开项目,右键点击项目→卸载项目→重新加载项目
  • 若“Application”板块仍缺失,执行VS设置重置(管理员命令提示符运行):
devenv /ResetSettings

4. 验证Windows构建环境

  • 在VS安装器的「单个组件」中,确认勾选了与项目配置匹配的Windows SDK版本(如10.0.22621.0)
  • 打开「Developer Command Prompt for VS 2022」,进入项目目录执行构建命令查看详细日志:
dotnet build -f net8.0-windows

根据日志定位是否有遗漏的依赖或配置错误。


内容的提问来源于stack exchange,提问作者TristanRomain

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.03 12:03:25