Makepad 快速开发参考指南：调试与布局实战

为 Makepad 开发者提供一套标准化的参考资料，涵盖常见错误修复、API 快速索引以及跨平台布局模式，解决在复杂 UI 开发中查找文档慢、调试难的问题。

为什么需要这个技能

Makepad 是一个高度灵活且复杂的 UI 框架，其 API 更新快且部分模式较为特殊。在实际开发中，开发者经常遇到难以通过常规手段排查的运行错误（如颜色解析失败或 UI 不刷新），或者在处理桌面端与移动端适配时缺乏统一的布局参考。

通过该技能，AI 可以迅速提供针对性的解决方案，避免开发者在庞大的代码库中盲目搜索，直接给出经过验证的修复方案和代码范式。

问题诊断：将错误信息（如 no matching field: font）输入 AI，匹配参考表中的快速修复方案。
查阅 API 矩阵：根据功能需求（如“API 文档”或“自适应布局”），引导 AI 从对应的参考文件中提取核心实现模式。
执行调试操作：
- 使用带有行号信息的命令运行程序：
```
MAKEPAD=lines cargo +nightly run
```
- 在 Rust 代码中插入关键日志进行状态跟踪：
```
log!("Value: {:?}", my_value);
log!("State: {} / {}", self.counter, self.is_loading);
```
验证与迭代：根据参考指南修正代码后，调用 redraw(cx) 确保 UI 状态实时更新。

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

暂无推荐