默认MAUI项目编译失败:AndroidManifest.xml不存在与project.assets.json缺失问题排查求助
解决MAUI项目编译时的AndroidManifest和NuGet资产文件问题
你遇到的是Preview版Visual Studio搭配MAUI时常见的工具链配置类问题,我帮你梳理几个针对性的修复步骤,按顺序尝试看看:
先处理AndroidManifest.xml缺失的问题
- 首先核对项目结构:MAUI项目的AndroidManifest.xml默认存放在
Platforms/Android文件夹下,而非项目根目录。打开你的项目,先确认这个路径下是否存在该文件。- 如果文件不存在,手动创建一个:右键点击
Platforms/Android文件夹 → 添加 → 新建项 → 选择「Android Manifest」,使用默认内容即可。 - 如果文件存在但编译仍提示找不到,检查项目的
.csproj配置:打开项目文件,搜索AndroidManifest关键词,确认配置的路径是Platforms/Android/AndroidManifest.xml,而非错误的根目录路径。
- 如果文件不存在,手动创建一个:右键点击
修复project.assets.json未找到的问题(即使已执行NuGet还原)
- 彻底清理缓存与生成文件:
- 先关闭Visual Studio。
- 手动删除项目文件夹下的
bin和obj两个目录。 - 打开命令提示符或PowerShell,导航到项目根目录,执行以下命令:
dotnet nuget locals all --clear dotnet restore
- 检查NuGet包源状态:打开Visual Studio → 工具 → NuGet包管理器 → 包源,确保
nuget.org源处于启用状态,没有被误禁用。 - 验证MAUI工作负载完整性:打开Visual Studio Installer,选择「修改」你的2022 Preview实例,确认
.NET Multi-platform App UI开发工作负载已安装,并且点击「更新」确保所有组件都是最新版本。
针对Preview版本的额外建议
- 你当前使用的是17.0 Preview 5,这个版本相对老旧,MAUI在后续的Preview迭代中修复了大量模板生成和编译链的问题。建议升级到最新的Visual Studio 2022 Preview版本,这大概率能直接解决这类模板初始化异常。
- 尝试创建一个全新的MAUI项目,如果新项目能正常编译,说明你当前项目的模板生成存在异常,可以把新项目里的
Platforms/Android目录、.csproj配置等复制到现有项目中覆盖。
最后检查权限问题
确认你的项目所在文件夹不是Windows受保护目录(比如C:\Program Files或系统盘根目录),这类目录会限制Visual Studio的写入权限,导致无法生成obj文件夹下的资产文件。如果是,把项目移动到普通用户目录(比如C:\Users\你的用户名\source\repos)后再重试。
内容的提问来源于stack exchange,提问作者RredCat
相关产品推荐
相关产品推荐

