Ubuntu Linux系统无法创建.NET MAUI项目求助

可能原因 #

• MAUI工作负载未正确注册到.NET模板系统
• VS Code的C#扩展未加载MAUI模板
• .NET模板缓存损坏
• SDK与MAUI工作负载版本不兼容

解决步骤 #

1. 重新安装并注册MAUI工作负载 #

先卸载现有MAUI工作负载，再重新安装确保注册到位：

dotnet workload uninstall maui
dotnet workload install maui --source https://api.nuget.org/v3/index.json

安装完成后，运行以下命令确认模板是否存在：

dotnet new --list | grep MAUI

如果能看到maui、maui-blazor等模板，说明模板已注册成功。

2. 重置VS Code的C#扩展模板缓存 #

VS Code的C#扩展可能缓存了旧的模板列表，重置缓存：

• 打开VS Code，按下Ctrl+Shift+P
• 输入> .NET: Reset OmniSharp并执行
• 重启VS Code后再次尝试创建项目

3. 手动创建MAUI项目并导入VS Code #

如果VS Code模板列表仍不显示，直接用命令行创建项目再导入：

dotnet new maui -n MyMauiApp
cd MyMauiApp
code .

后续可通过dotnet build、dotnet run命令编译运行项目。

4. 检查SDK与MAUI工作负载版本兼容性 #

确保.NET SDK版本和MAUI工作负载版本匹配（比如.NET 7对应MAUI 7，.NET 8对应MAUI 8）。运行dotnet --info查看SDK版本，再用dotnet workload list确认MAUI工作负载版本，若不一致则升级或降级SDK到匹配版本。

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