makepad-2.0-troubleshooting

makepad-2.0-troubleshooting 技能概览

makepad-2.0-troubleshooting 是一款面向 Makepad 2.0 和基于 Splash 的应用的聚焦型排障技能。它最适合你已经有明确症状的时候——比如 UI 不显示、点击失效、编译报错、热重载失败，或者迁移后出现回归问题——并且需要快速定位最可能的原因和修复方式。如果你正在调试一个用于 Backend Development 的 Makepad 2.0 应用，或者一个 UI 密集型工具链，这个技能的设计目标就是减少猜测，把症状直接翻译成代码级修正。

这项技能最适合处理什么问题

当你需要的是“从症状到修复”的指引，而不是泛泛的 Makepad 学习内容时，就用 makepad-2.0-troubleshooting。它最擅长处理这类问题：

• 让控件消失的布局问题
• 语法和宏迁移错误
• 事件、渲染和更新循环问题
• 看起来“差不多能跑”但总差一口气的运行时行为

它和通用提示词有什么不同

通用提示词往往只会给出范围很大的建议，却容易漏掉 Makepad 特有的坑，比如 Fill 和 Fit 的差异、script_mod! 迁移，或者命名/覆盖语法问题。这个 makepad-2.0-troubleshooting 指南是围绕常见失败模式及其具体修复方式构建的，所以当你的主要目标是诊断和修复时，它更适合直接安装使用。

你可以期待它输出什么

如果你能提供准确症状、相关代码片段，以及问题发生的文件，这个技能的效果最好。它通常会指出根因、给出修正后的模式，并提醒你那些经常和同类 bug 一起出现的连带问题。它不是完整的框架教程，而是一个帮助你更快解决问题的排障层。

如何使用 makepad-2.0-troubleshooting 技能

在支持仓库上下文的工作流里安装

先在你的 skills 工具链里完成 makepad-2.0-troubleshooting 的安装流程，然后只在任务明确属于 Makepad 2.0 故障时启用它。为了获得最佳效果，尽量把当前请求限制在一个 bug、一个文件或一个迁移步骤内，这样技能才能把症状对应到正确的坑位。

输入症状，不要输入笼统目标

makepad-2.0-troubleshooting 最好的使用方式，是从一条精确的问题描述开始：

• 差： “我的应用坏了”
• 更好： “Fit 父容器里的 View 渲染出来是 0px 高”
• 更好： “迁移到 Makepad 2.0 之后，live_design! აღარ能编译了，我需要替代写法”

请尽量附上：

• 精确的报错文本（如果有）
• 最小相关代码块
• 你原本预期看到的结果
• 这是迁移问题、渲染问题还是事件问题

先看这些文件

使用 makepad-2.0-troubleshooting 时，先预览 SKILL.md，然后再看 references/error-solutions.md。这两个文件能最快把症状映射到修复方式。如果你的本地副本里还有额外上下文文件或链接文档，也要等你先确认问题类别之后再看，因为这里最核心的价值就在于经过整理的“坑位到解决方案”对应关系。

使用“先诊断，再修复”的提问结构

高质量的提问通常长这样：

我正在使用 Makepad 2.0。把一个 View 嵌套进 Fit 父容器后，Window 内容完全不显示了。这里是布局代码和完整的容器层级。请诊断最可能的原因，并给出修正后的写法。

这比问“有什么建议”更有效，因为技能可以直接锚定已知坑点，输出更窄、更实用的修复方案。

makepad-2.0-troubleshooting 技能常见问题

这个技能只适用于 Makepad 2.0 迁移问题吗？

不是。迁移错误是它的主要使用场景之一，但 makepad-2.0-troubleshooting 也覆盖运行时 bug、布局问题、事件处理问题，以及“代码已经能编译了但为什么什么都不显示”这类场景。

能代替看文档吗？

把它当成快速排障层，而不是核心文档的替代品。它最有价值的地方在于：你已经有了具体症状，并且想走最短路径找到修复。如果你是在从零设计应用，通常还是先看通用的 Makepad 指南更合适。

它适合初学者吗？

适合，只要你能提供报错信息或者最小代码片段。makepad-2.0-troubleshooting 之所以对初学者友好，是因为它会用“症状 / 原因 / 修复”的方式来组织问题。若你只说“它不工作”，却没有上下文，它就没那么好用。

什么时候不该用这个技能？

不要把它当成处理宏观架构决策、UI 设计模式，或者无关 Rust 调试的工具。它非常适合 Makepad 特有的故障，但不适合那些失败点已经超出框架常见坑位的任务。

如何提升 makepad-2.0-troubleshooting 的效果

提供准确的 Makepad 2.0 上下文

当你补充版本、文件类型和出错代码路径时，makepad-2.0-troubleshooting 的表现最好。请说明你是在 script_mod!、widget tree 还是事件处理器里，因为正确修复往往取决于 bug 出现的位置。

给出最小可复现片段

紧凑片段比整份应用代码更有用。比如按钮点击没有触发时，只要贴出相关的 widget 层级和处理代码即可。这样技能更容易区分到底是命名问题、可见性问题，还是事件传播问题。

不只要诊断，还要修复模式

想让 makepad-2.0-troubleshooting 更好用，提问时最好同时要求：

• 可能的根因
• 修正后的代码模式
• 需要顺手检查的边缘情况

这比一句话答案更有价值，因为它能帮助你验证修复，并避开下一个坑。

第一次回答后继续迭代

如果第一次给出的修复没有解决问题，就回复新的报错、修改后的代码片段，以及仍然没有修好的部分。这个技能最有效的使用方式，是不断缩小问题树的分支，而不是从零重来。