最近我一直在解决一个很具体、也很磨人的问题:按钮明明在,层级看着也没问题,Preview 里就是点不动。
这种时候最耗时间的不是改,而是不知道先查谁——是上面盖了 BlockInputEvents,还是 Mask、Canvas、Camera,或者事件在传播中途被停掉了?
所以我做了 Cocos Doctor。第一步不是猜,而是记录一次真实 Preview 点击。
22 秒案例短片(B 站审核通过后即可播放):
https://www.bilibili.com/video/BV1PnKm6dEKA/
在 macOS 的 Cocos Creator 3.8.8 里,它会在当前可靠支持的范围内告诉你三件事:这次实际点中了谁、最后交给了谁、又在哪里停住。它不会拿矩形重叠冒充真实 hit-test;证据不够,就明确标成“不支持”或“需要确认”。
如果碰到当前支持的修复项,可以先看它准备改哪些属性,再决定要不要应用。修复前后用同一个操作各跑一遍:之前点不到,改完能点了,才标记为已验证。需要撤回,也可以撤回这一次修改。
另一个入口是四屏体检:16:9、19.5:9 + safe area、4:3 / tablet,以及当前自定义分辨率。扫描不写项目,结束后恢复原视口。
首发实机范围:
- macOS
- Cocos Creator 3.8.8
- 本机需要安装兼容的 Google Chrome
Windows、Linux 和其他 Creator 版本不在 1.0 首发实机承诺内。
核心排查不配 API Key 也能完成。AI 只是可选解释层;要发送的内容会先给你看,要不要联网由你决定。
Cocos Store:
https://store.cocos.com/app/detail/9113
首发优惠(北京时间):
2026/7/21 00:00—2026/8/4 00:00,¥239
日常价 ¥299
中文安装视频:
https://www.bilibili.com/video/BV1tPNZ6WE49/
如果你也卡在“按钮明明在,却点不到”,可以回复 Creator 版本、操作系统、附近可能相关的节点,以及最短复现步骤。我会先看这个真实问题,不需要你发完整项目。
请不要公开项目文件、公司或人员名称、路径、账号、密钥、订单信息或商业 ZIP。

