需安装.NET 8+ SDK、MAUI工作负载、C# Dev Kit扩展，并手动配置launch.json、终端构建命令及Razor热重载支持，方可实现VSCode中.NET MAUI跨平台开发与调试。
如果您希望使用 Visual Studio Code 开发 .NET MAUI 应用，但发现缺少项目模板、调试支持或平台构建能力，则可能是由于扩展配置不完整或 .NET SDK 环境未正确就绪。以下是实现 VSCode 中 .NET MAUI 开发的多种可行路径：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装必要组件与扩展
VSCode 本身不原生支持 .NET MAUI，需通过组合安装 .NET SDK、C# 扩展及 MAUI 工作负载来构建开发基础。该步骤确保 CLI 命令可识别 maui 模板并能生成跨平台项目结构。
1、打开终端，执行 dotnet --list-sdks 确认已安装 .NET 8 SDK 或更高版本。
2、运行 dotnet workload install maui 安装 MAUI 工作负载。
3、在 VSCode 中安装官方 C# Dev Kit 扩展（含 C#、.NET Runtime Extension Pack 依赖）。
4、重启 VSCode 并通过命令面板（Cmd+Shift+P）运行 .NET: Create a new project，验证是否出现 .NET MAUI App 模板。
二、手动配置 launch.json 以启用多平台调试
默认情况下，VSCode 的 C# Dev Kit 不为 MAUI 提供预设调试配置，需手动定义针对 iOS Simulator、Android Emulator 和 macOS 的启动项。该配置使 F5 启动时可选择目标运行时。
1、在项目根目录下创建 .vscode/launch.json 文件。
2、填入包含 android、ios、maccatalyst 的 configuration 数组，每个 entry 的 program 字段指向 bin/Debug/net8.0-android/YourApp.dll 对应路径。
3、为 Android 配置添加 "env": { "DOTNET_ROOT": "/usr/local/share/dotnet" }，确保模拟器进程可访问运行时。
4、保存后点击调试侧边栏的下拉菜单，确认三个平台选项均已列出。
三、使用 Terminal 集成构建与部署
VSCode 内置终端可直接调用 dotnet CLI 完成构建、打包与设备部署，绕过图形化 IDE 限制。该方式适用于无 Xcode 或 Android Studio GUI 的轻量开发场景。
1、在集成终端中执行 dotnet build -t:Run -f net8.0-android 启动 Android 模拟器并加载应用。
2、若需部署至连接的物理 iOS 设备，先运行 dotnet build -t:Run -f net8.0-ios --configuration Release，再通过 xcrun altool --upload-app 提交 IPA（需 Apple Developer 账户签名配置）。
3、对 macOS 目标，执行 dotnet build -t:Run -f net8.0-maccatalyst 并确认系统允许运行已识别开发者应用。
四、启用 Razor 编译与热重载支持
MAUI Blazor 应用依赖 Razor 文件实时编译与热重载，需调整 VSCode 设置以激活该功能。否则修改 .razor 文件后需手动重启调试会话。
1、在用户设置 JSON（Cmd+, → Open Settings JSON）中添加 "csharp.dotnetCliPaths": ["/usr/local/share/dotnet/dotnet"]。
2、在项目根目录的 .csproj 文件中，确认存在
3、启动调试前，在终端运行 dotnet watch --project YourApp.csproj，并在浏览器中访问 https://localhost:5001 查看热更新效果。
