用MAUI创建首个项目只需安装VS 2022(17.4+)或.NET SDK 6.0+,新建.NET MAUI App模板,命名HelloWorld后F5运行,默认启动Windows版;可改MainPage.xaml中Text属性快速更新界面。

用 MAUI 创建第一个项目非常简单,只要装好开发环境,几秒钟就能跑起 HelloWorld。
确认开发环境已安装
MAUI 是 .NET 6+ 的跨平台框架,需要以下基础环境:
- Visual Studio 2022(推荐 17.4 或更新版本),安装时勾选 “使用 .NET 的移动开发” 工作负载
- 或使用 Visual Studio for Mac(需 macOS 13+ + .NET 7+)
- 命令行方式需确保已安装 .NET SDK 6.0 或更高版本(终端运行
dotnet --version查看)
用 Visual Studio 创建 MAUI 项目
打开 Visual Studio → 新建项目 → 搜索 “MAUI” → 选择 “.NET MAUI App” 模板 → 点击下一步:
- 项目名称填
HelloWorld,位置自选 - 解决方案名称默认一致即可
- 点击创建后,VS 会自动生成包含 Android、iOS、macOS、Windows 四个平台的项目结构
生成完成后,直接按 F5 运行,默认启动 Windows(如果启用了 Windows 平台支持);想跑 Android,需先配置模拟器或连接真机,并在工具栏选择 HelloWorld (Android) 后再运行。
快速理解 HelloWorld 代码结构
项目打开后,重点关注两个文件:
-
MainPage.xaml:界面定义,里面默认有个
Label显示 “Hello, World!” - MainPage.xaml.cs:后台逻辑,目前为空,可在此添加按钮点击事件等
比如想改文字,只需双击 MainPage.xaml,把 Text="Hello, World!" 改成 Text="你好,MAUI!",保存后重新运行即可看到效果。
命令行方式(适合轻量开发或 CI 场景)
打开终端,执行以下命令:
dotnet new maui -n HelloWorld
cd HelloWorld
dotnet run
默认会在 Windows 上启动;若在 macOS 上运行 iOS 版本,需加参数:dotnet build -t:Run -f net8.0-ios(需已配好 Apple 开发证书和签名)
基本上就这些。不需要额外配置 UI 框架、状态管理或构建脚本,MAUI 内置全搞定。第一次运行稍慢(因首次恢复 NuGet 包和生成平台资源),后面就快了。










