Makepad Reference 是 Makepad 框架的参考与排错资料集合，用于在开发 Makepad 应用时进行问题排查、代码质量维护和高级布局处理。
用途 该资料主要服务于 Makepad 开发过程中的调试与查阅需求。当出现构建失败、运行时错误，或需要查找具体 API 信息、简化代码、处理跨平台布局时，可以按主题定位到对应内容。
主要能力 资料按主题组织，包含以下几类：
- API 文档：官方文档索引与快速 API 参考，用于查找详细的 API 信息。
- 排错（Troubleshooting）：常见错误及其修复方法，适用于构建失败和运行时错误。
- 代码质量：Makepad 感知的重构指导，用于安全地简化代码。
- 自适应布局：桌面与移动端响应式布局，用于跨平台布局场景。
常见问题速查 资料提供了一份常见问题与快速修复对照：
- no matching field: font —— 使用 text_style: <THEME_FONT_*>{}
- 颜色解析错误（以 e 结尾）—— 修改最后一位数字（例如 #14141e → #14141f）
- set_text 缺少参数 —— 将 cx 作为第一个参数加入
- UI 不更新 —— 在修改后调用 redraw(cx)
- 控件找不到 —— 检查 ID 拼写，路径使用 ids!()
调试技巧 资料给出以下调试方式：
- 带行号信息运行以获得更好的错误信息：MAKEPAD=lines cargo +nightly run
- 添加日志：log!("Value: {:?}", my_value); 以及 log!("State: {} / {}", self.counter, self.is_loading);
适用场景 适合在 Makepad 项目构建失败、运行时报错、需要查找 API、进行代码重构或处理桌面与移动端自适应布局时查阅。
限制 资料未提供关于收费、价格、平台支持范围或具体效果保证的信息，这些内容暂未提供。