ContentPage 是页面容器,ContentView 是可复用视图组件。两者定位不同:一个管“导航层级”,一个管“UI复用”。不搞混,开发就顺一大半。
ContentPage:承载完整页面的顶层容器
它是 .NET MAUI 应用中最常用的页面类型,代表一个独立的、可导航的屏幕。比如登录页、首页、设置页——每个都该是一个 ContentPage。
必须作为页面导航体系中的节点,能被 NavigationPage 或 Shell 推入/弹出 自带 Title、BackgroundColor、Padding、HideSoftInputOnTapped 等页面级属性 Content 属性是它的核心,但只允许设一个子元素(通常是 Grid、StackLayout 这类布局) 在 XAML 中它是根元素,不能嵌套在其他 ContentPage 里,也不能直接当普通控件加到别的页面中ContentView:轻量、可嵌套、可绑定的自定义视图
它不是页面,而是一个“UI零件”——类似你做的一个带标题和按钮的卡片、一个带图标和文字的状态栏,或一套表单字段组合。
只能包含一个直接子元素(Content 属性),但这个子元素可以是任意复杂布局 支持 BindableProperty,天然适配 MVVM,比如你可以定义 CardTitle、IsEnabled 等可绑定属性 能被自由添加到 ContentPage、ShellContent、甚至另一个 ContentView 里,复用性极强 没有导航能力,也不参与页面栈管理;它只是“长在页面上的内容”什么时候该用哪个?看场景
判断很简单:
要跳转、要出现在导航栏上、要响应 OnAppearing/OnDisappearing —— 选 ContentPage 要封装一组逻辑相关的 UI、要在多个页面重复使用、要暴露属性给绑定 —— 选 ContentView 想把整个设置页做成卡片式模块?不行,ContentView 不能替代页面导航。但可以把“账号设置区块”抽成 ContentView,再放进 SettingsPage(ContentPage)里基本上就这些。ContentPage 定义“在哪”,ContentView 定义“长啥样”。分清角色,结构自然清晰。
