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

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

看懂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里藏着资源管理的关键

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

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

执行顺序帮你理清加载链条

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

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

基本上就这些。结构看着多，其实每层只干一件事，共享代码写在中间，平台补丁放在边上，资源由.csproj统一分发——不复杂但容易忽略配置细节。