MAUI项目结构怎么看懂 MAUI解决方案结构详解-C#.Net教程-PHP中文网

MAUI项目结构怎么看懂 MAUI解决方案结构详解

月夜之吻

发布： 2025-12-21 08:31:13

原创

888人浏览过

MAUI项目结构遵循“共享优先、平台按需覆盖”逻辑：根目录放共享业务代码（Views/ViewModels等），Platforms/存平台专属配置，Resources/统一管理静态资源，.csproj自动处理资源打包与平台回退。

maui项目结构怎么看懂 maui解决方案结构详解

看懂MAUI项目结构，关键不是死记目录名，而是理解“共享优先、平台按需覆盖”这个设计逻辑。它用一套目录规则，自动协调跨平台共性与各端差异，不搞多项目拆分，也不强求完全一致。

一个新建的MAUI项目，默认包含三大功能区：

Platforms/：放平台专属代码和配置，比如Android的AndroidManifest.xml、iOS的Info.plist、Windows的启动图标和窗口设置。这里只写“不得不写”的部分，比如调用原生相机、处理后台定位权限。
Resources/：统一管所有静态资源。子目录很清晰：Images/放图片（支持自动适配@2x/@3x）、Fonts/放ttf字体、AppIcon/和Splash/分别管应用图标和启动页——这些资源会被构建系统自动复制、转换、打包到对应平台。
共享层（根目录下）：Views/、ViewModels/、Models/、Services/这些是真正写业务的地方。XAML界面+C#逻辑+数据模型全在这里，90%以上代码一次编写，四端通用。

项目文件（.csproj）不是摆设，它是资源如何被识别、打包的指令中心：

Pixelfox AI

多功能AI图像编辑工具

2108

用<mauiimage include="Resources\Images\**\*"></mauiimage>表示递归包含所有图片，不用每加一张图就手动添一行。
用<mauifont include="Resources\Fonts\*.ttf"></mauifont>批量注册字体，系统会自动为各平台做格式兼容处理。
平台特定资源可直接写进Platforms/Android/Resources/等路径，构建时会自动优先取用，没找到才回退到Resources/——你不需要写if-else判断平台。

启动过程有固定链路，顺着看就明白各文件职责：

先跑Platforms/{平台}/App.xaml.cs：操作系统入口，只做最轻量初始化，比如加载平台资源、调用MauiProgram.CreateMauiApp()。
再进MauiProgram.cs：注册服务、配置字体、启用Essentials、添加依赖注入容器——这是整个App的“配置中枢”。
最后到App.xaml.cs：实例化Application，设置MainPage（通常是AppShell），开始挂载UI树。