---

name: makepad-reference description: "此类别提供调试、代码质量和高级布局模式的参考材料。" risk: unknown source: community

Makepad 参考

此类别提供调试、代码质量和高级布局模式的参考材料。

何时使用

• 需要常见Makepad错误、调试或API查找的快速参考材料时
• 任务是诊断或参考导向而非在某个子系统中编写功能时
• 想要一个中心起点再深入更专业的Makepad技能时

快速导航

| 主题 | 文件 | 使用场景 | |------|------|----------| | API文档 | 官方文档索引 | 查找详细API信息 | | 故障排除 | 常见错误和修复 | 构建失败、运行时错误 | | 代码质量 | Makepad感知重构 | 安全简化代码 | | 自适应布局 | 桌面/移动响应式 | 跨平台布局 |

常见问题快速参考

| 错误 | 快速修复 | |------|----------| | no matching field: font | 使用 text_style: <THEME_FONT_*>{} | | 颜色解析错误（以e结尾） | 更改最后一位（如 #14141e → #14141f） | | set_text 缺少参数 | 添加 cx 作为第一个参数 | | UI不更新 | 更改后调用 redraw(cx) | | Widget未找到 | 检查ID拼写，路径使用 ids!() |

调试技巧

# 带行信息运行以获得更好的错误消息
MAKEPAD=lines cargo +nightly run

// 添加日志
log!("Value: {:?}", my_value);
log!("State: {} / {}", self.counter, self.is_loading);

资源

• Makepad官方文档
• Makepad仓库
• Robrix - 生产参考
• Moly - 生产参考