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

来源:这里教程网 时间:2026-02-21 17:34:35 作者:

看懂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)不是摆设,它是资源如何被识别、打包的指令中心:

<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树。

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

相关推荐