明明加了元素，编辑器或前台却看不到？这是 Bricks 新手常见故障。本文列原因与排查清单。
现象
在画布里拖了元素、保存了，但编辑器画布一片空白，或前台不显示刚加的内容。
常见原因与排查
- 元素在视口外/被容器挡：确认元素确实落在可见的 Container 里，而不是被别的块覆盖或溢出隐藏。
- 缓存：优化/缓存插件把旧版页面缓存了，清缓存再刷新。
- 条件/设备显示：检查元素条件是否把它在「当前设备/用户」下隐藏了。
- z-index / 溢出：父容器设了 overflow hidden 或元素被推到可视区外。
- JS 报错：浏览器控制台有报错时编辑器可能渲染不全，关掉冲突插件试。
通用排查顺序
先关缓存插件 → 切设备看是否仅某端不显 → 检查元素条件 → 看控制台报错 → 逐个禁用插件定位冲突。
小结
「加了元素不显示」多半是缓存、条件隐藏、容器溢出或插件冲突。按「缓存→设备→条件→控制台→插件」顺序排查，基本都能定位。
内容说明（整理稿）：本文选题与步骤框架参考自竞对站 trybricks.com / qinbanliang 站的公开教程（源多为截图驱动教程，正文极薄），内容为 BricksWiki 基于 Bricks 官方公开文档与通用实操经验重写整理，非原文逐字翻译，也不构成官方文档。操作入口/路径以你当前 Bricks 版本为准，实操前建议对照官方文档核对。
延伸阅读
tutorial
Bricks 编辑界面与基础操作：新手的第一课
拆解 Bricks 编辑器三区布局、顶部栏断点与保存、小部件的添加/复制/删除，以及单位、样式继承、自定义 CSS 等日常必懂的基础概念。
tutorial如何使用 Bricks Builder 编辑我的第一个页面
教程：适合纯新手。带你走完编辑第一个 Bricks 页面的完整闭环——进编辑器、认识界面、拖元素、改样式、保存发布。
tutorialBricks Builder 主题 Rank Math SEO 分析不生效
教程：Rank Math 在 Bricks 页面读不到正文、评分失效的成因与解法——补古腾堡正文或把 SEO 要素做实在。
tutorial什么是 Bricks Builder 画布
教程：刚装好 Bricks 不知道哪块能拖东西？画布就是那个实时预览加编辑的可视化区域，搞懂它你才算真正上手。