VS 2022与Mac配对连接失败求助（.NET MAUI开发场景）

Windows端操作 #

• 深度清理配对缓存：除删除.vs目录外，删除%LOCALAPPDATA%\Xamarin\MonoTouch下的所有配对相关文件，再清空%LOCALAPPDATA%\Microsoft\VisualStudio\<你的VS版本号>\ComponentModelCache目录，之后重启VS。
• 检查VS Mac代理服务：按下Win+R输入services.msc打开服务列表，找到Visual Studio Mac Agent，确保服务处于运行状态，启动类型设为「自动」。若未运行，手动启动后重启VS重试连接。
• 手动IP+SSH密钥连接：
  1. Windows终端运行ssh-keygen生成SSH密钥（一路回车默认设置即可）；
  2. 将生成的C:\Users\<你的用户名>\.ssh\id_rsa.pub内容复制到Mac的~/.ssh/authorized_keys文件中；
  3. 在Mac终端执行chmod 600 ~/.ssh/authorized_keys设置权限；
  4. 打开VS的Mac连接窗口，选择「Add Mac」，手动输入Mac的局域网IP，选择「SSH Key」认证方式完成配对。

Mac端操作 #

• 同步工具版本：确保Mac上的Xcode为对应VS版本支持的稳定版，终端执行dotnet workload update maui更新.NET MAUI工作负载，避免版本不兼容导致连接异常。
• 重置VS代理进程：终端执行killall -9 VSMacAgent强制终止代理进程，再通过系统设置→通用→共享，先关闭再重新开启「远程登录」，并确保当前登录用户在允许访问列表内。
• 清理MAUI缓存：终端执行以下命令清理本地缓存，之后重新恢复项目NuGet包：

  rm -rf ~/.local/share/Xamarin
  rm -rf ~/.nuget/packages/*maui*
  

• 排查网络防火墙：关闭Mac防火墙临时测试，或在防火墙设置中允许VSMacAgent通过；同时确保Windows与Mac处于同一局域网，关闭两端的VPN、代理软件。

进阶配置调整 #

• 延长VS连接超时：打开VS选项→Xamarin→iOS Settings，将「Connection Timeout」从默认30秒调整为60秒，避免因网络延迟导致连接中断。
• 禁用IPv6：在Windows和Mac的网络设置中暂时禁用IPv6，仅使用IPv4进行连接，部分网络环境下IPv6会干扰配对流程。

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