Visual Studio 2022 Preview无法在MacOS运行调试.NET MAUI应用

第一步：先校验基础环境完整性 #

• 打开终端执行dotnet workload list，确认输出结果包含maui-maccatalyst、maui-android、maui-ios三个必要工作负载；如果有缺失，直接执行sudo dotnet workload install maui自动补装所有MAUI相关依赖
• 启动一次Xcode，等待首次启动的附加组件安装完成后，进入Xcode设置-位置页，确认「命令行工具」项选中你当前安装的Xcode正式版本，不能留空
• 终端执行sudo xcodebuild -license accept，接受Xcode许可协议，避免后续调用苹果编译工具链时权限报错

第二步：修复调试启动配置，解决点击Debug弹出命令输入框的问题 #

你遇到的弹命令输入窗口问题，基本都是调试目标没选对导致的：

• 找到Visual Studio顶部的调试目标下拉菜单，不要选「默认」「自定义命令」这类通用选项，必须选中具体的运行目标：
  • 要运行Mac原生版本，选对应netX.0-maccatalyst框架下的「My Mac」选项
  • 要运行iOS版本，选你需要的iOS模拟器设备（比如iPhone 15 iOS 17），或者连接的iOS真机
  • 要运行安卓版本，选已经创建好的安卓模拟器，或者USB连接的安卓真机
• 如果下拉菜单里看不到上述具体设备/目标选项，先关闭Visual Studio，在项目根目录打开终端执行dotnet restore还原所有依赖，再重新打开解决方案加载项目
• 右键项目名，先选「清理解决方案」，再选「重新生成解决方案」，等生成完成后再尝试启动调试

第三步：首次启动常见问题处理 #

• 首次运行MacCatalyst版本时如果弹安全拦截，直接打开系统设置-隐私与安全性，拉到页面最下方点击「仍要打开」，给应用授予运行权限即可
• 如果启动安卓版本提示SDK缺失，直接打开Visual Studio设置- SDK和工具页，勾选对应安卓平台版本的SDK、构建工具，点击安装后会自动补全配置
• 全新未修改的默认MAUI项目不需要额外添加自定义配置，只要环境校验通过、选对具体调试目标即可正常启动运行

注意：如果多次操作后还是弹出命令输入窗口，可以先重启Visual Studio再重新选择调试目标，大部分缓存类问题重启后都会自动消失

内容的提问来源于stack exchange，提问作者Omar Ebrahim