VS2026中Pair To Mac连接后立即断开(XCode26.5环境)
排查VS 2026 Pair to Mac连接立即断开的方案
以下是针对你的场景可尝试的排查步骤:
重启Mac上的VS构建服务:在Mac终端执行以下命令重启构建主机服务,解决服务异常导致的断开问题:
launchctl stop com.microsoft.visualstudio.mac.build.host launchctl start com.microsoft.visualstudio.mac.build.host也可以打开「活动监视器」,找到
Visual Studio for Mac Build Host进程,强制退出后重新启动。清理配对缓存:
- Windows端:删除
%LOCALAPPDATA%\Xamarin\MonoTouch目录下的所有配对相关文件; - Mac端:删除
~/Library/Caches/Xamarin/XMA目录内容;
清理完成后重新发起配对流程。
- Windows端:删除
校验.NET SDK版本一致性:确保Windows和Mac上安装的.NET 10 SDK版本完全一致(包括预览版编号)。分别在Windows命令提示符和Mac终端执行
dotnet --version查看版本,若不一致,卸载旧版本并安装相同版本的SDK。深度验证SSH连接:
- 使用VS配对向导中的「测试连接」功能,查看具体的连接失败提示;
- 检查Mac的SSH配置(
/etc/ssh/sshd_config),确认PasswordAuthentication设置为yes(若使用密码配对),或确保公钥已正确添加到Mac的~/.ssh/authorized_keys中; - 避免使用含特殊字符的Mac用户名或密码,防止配对时解析异常。
检查系统权限与防火墙:
- Windows端:临时关闭第三方安全软件,检查Windows防火墙是否允许Visual Studio的网络访问;
- Mac端:打开「系统设置-隐私与安全性」,确保
Visual Studio for Mac Build Host拥有「完全磁盘访问」权限;同时检查Mac防火墙是否允许该进程的出站连接。
重装MAUI工作负载:
- Windows终端执行:
dotnet workload uninstall maui dotnet workload install maui - Mac终端执行相同命令,重新安装.NET 10 MAUI工作负载,修复可能损坏的组件。
- Windows终端执行:
查看配对日志定位错误:
- Windows日志路径:
%LOCALAPPDATA%\Xamarin\Logs\17.x(替换为VS 2026对应的版本目录); - Mac日志路径:
~/Library/Logs/Xamarin/XMA/BuildHost;
打开日志文件,查找连接断开时刻的错误信息(如认证失败、进程崩溃、组件缺失等),针对性解决问题。
- Windows日志路径:
测试空白项目配对:新建一个空白的Blazor MAUI项目,尝试配对操作,排除当前项目配置或依赖导致的异常。
内容的提问来源于stack exchange,提问作者bbWebDev
相关产品推荐
相关产品推荐

