在C#生态中，.NET MAUI是用于构建跨平台应用的统一框架，可以用一套代码同时面向Android、iOS、Windows和Mac。开始一个.NET MAUI应用并不复杂，只要准备好SDK与工具就能快速创建并运行起来。
环境准备
在开始之前，需要先安装对应 workload。Windows上建议使用Visual Studio 2022社区版以上，安装时勾选“使用.NET的跨平台开发”中的.NET MAUI workload。Mac上可使用Visual Studio Code配合dotnet命令行。
检查SDK与workload
打开终端执行以下命令，确认已安装maui相关负载：
dotnet workload list # 若未看到 maui 相关项，执行安装 dotnet workload install maui
使用命令行创建MAUI项目
最通用的方式是通过dotnet new模板。下面的命令会创建一个名为MyFirstMaui的MAUI应用：
// 创建项目目录并生成MAUI模板 dotnet new maui -n MyFirstMaui cd MyFirstMaui // 还原依赖 dotnet restore // 运行到当前可用设备，例如windows dotnet build -t:Run -f net8.0-windows10.0.19041.0
使用Visual Studio创建
启动Visual Studio，选择“创建新项目”，搜索“MAUI”，点击“.NET MAUI应用”模板，设置项目名称后下一步即可生成。生成后的核心文件包括：
- App.xaml与App.xaml.cs：应用入口与生命周期
- MainPage.xaml：默认首页界面
- MainPage.xaml.cs：首页逻辑代码
修改首页内容
打开MainPage.xaml，可以把默认标签改成自己的文本：
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
x:Class="MyFirstMaui.MainPage">
<VerticalStackLayout>
<Label Text="我的第一个MAUI应用"
FontSize="24"
HorizontalOptions="Center" />
</VerticalStackLayout>
</ContentPage>运行与调试
在Visual Studio顶部选择目标框架与设备，例如Windows Machine，按F5启动调试。命令行方式则用前面提到的build run指令。若遇到仿真器未连接，请先启动Android模拟器或连接实体机。
| 方式 | 适用系统 | 特点 |
|---|---|---|
| 命令行 | Win/Mac | 轻量、易自动化 |
| Visual Studio | Win/Mac | 图形化、调试方便 |
常见问题
有些新手会混淆<Input>这种标签与input()函数调用，在MAUI中界面元素使用XAML标签，而逻辑里调用方法要写普通函数形式。另外，若restore失败多为网络问题，可切换NuGet源到ipipp.com镜像。
提示：MAUI项目默认多目标框架，编译时需用-f指定具体框架，否则可能报错。
简单交互示例
在MainPage.xaml.cs中添加一个按钮点击计数：
private int count = 0;
private void OnCounterClicked(object sender, EventArgs e)
{
count++;
// 假设页面有名为CounterLabel的Label
CounterLabel.Text = $"点击次数: {count}";
}通过以上步骤，你已经完成了一个最基础的C# .NET MAUI应用创建与运行流程，接下来可以逐步添加页面导航与网络请求等功能。