VS2017+Qt5.12.9调试QML报无法连接socket错误，如何排查配置？

1 Qt VS Tool全局与项目配置检查 #

• 确认Qt VS Tool全局调试开关已开启：打开VS菜单栏Qt VS Tools->Options->Qt->General，勾选Enable QML Debugging选项，该全局配置优先级高于项目单独设置，是最容易遗漏的配置项。
• 确认项目QML调试参数完整：右键项目->属性->Qt Project Settings->QML/JS，除开启QML调试开关外，需确认Debugging port未被系统其他进程占用，也未被防火墙拦截，可手动指定一个10000-65535区间内的空闲端口测试。

2 构建与运行配置检查 #

• 确认当前使用Debug构建版本运行，Release版本默认屏蔽QML调试相关逻辑，仅开启项目选项无法生效。
• 确认qmake附加参数包含调试标识：右键项目->属性->配置属性->qmake->常规，检查附加参数中是否存在QML_DEBUG=1 QML_JIT=1，缺失则手动添加后重新执行qmake、全量构建项目。
• 临时关闭系统防火墙/安全软件测试：QML调试依赖本地socket通信，部分安全软件会拦截VS调试器与Qt应用的本地连接，若关闭后可正常连接，手动添加VS和目标应用的出入站规则即可。

3 手动附加进程场景的特殊配置 #

如果是手动附加进程调试而非直接F5启动，需要先给应用添加启动参数后再运行：

你的应用程序.exe -qmljsdebugger=port:xxxx,block
其中xxxx替换为项目配置中指定的端口号，block参数会让应用启动后阻塞等待调试器连接，再通过VS调试->附加到进程，选择附加类型为Qt QML Debugger，选中目标应用进程附加即可。

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