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统一分发——不复杂但容易忽略配置细节。










