如何在 Bricks Builder 中使用 ACF（Advanced Custom Fields）

ACF 是 WordPress 里最流行的自定义字段插件，能让你给文章、产品、页面挂上任意结构化字段（文本、图片、关联、复选等）。Bricks 原生支持把 ACF 字段当作动态数据调用，所以「ACF 存数据 + Bricks 显示数据」是做复杂站型的标配组合。本文讲清楚怎么在 Bricks 里把 ACF 字段拉出来用。

ACF 与 Bricks 的配合逻辑

ACF 负责「定义字段并存储」，Bricks 负责「读取并排版展示」。两者通过动态数据（Dynamic Data）机制打通：你在 Bricks 元素的任意文本、图片、链接位置，都能插入 {acf_field} 这类动态标签，前台渲染时自动替换成该字段的真实值。

第一步：用 ACF 创建字段组

1. 后台安装并启用 Advanced Custom Fields。
2. 进入「自定义字段 → 字段组」，新建一个字段组，添加你需要的字段（如「产品参数」文本框、「封面图」图片字段）。
3. 在「位置规则」里指定这个字段组出现在哪种内容类型上（如文章、产品或某个自定义文章类型）。
4. 发布字段组，然后去对应内容的编辑页就能填值了。

第二步：在 Bricks 中调用 ACF 字段

1. 用 Bricks 打开要展示的模板或页面，选中一个文本类元素（如 Basic Text、Heading）。
2. 在内容区输入花括号 {，Bricks 会弹出动态数据选择器。
3. 选择来源为 ACF，找到你刚建的字段名，确认插入。
4. 图片类字段同理：在 Image 元素的「动态数据」里选 ACF 字段即可。

第三步：处理关联与高级字段

ACF 的关系（Relationship）、重复器（Repeater）等复杂字段，Bricks 的 Query Loop 也能消费。比如用 Query Loop 绑定一个 ACF 关联字段，就能循环输出关联的文章列表。遇到字段不显示时，先确认字段组的位置规则是否命中当前内容，再检查动态数据来源是否选对。

小结

ACF 给内容加结构，Bricks 把结构漂亮地呈现出来。记住三步：ACF 建字段组并设位置规则 → Bricks 里用 { 插入动态数据选 ACF → 复杂字段交给 Query Loop。把这套跑顺，你的站点就能脱离「纯文章」，承载产品参数、规格表等真实业务数据。

内容说明（整理稿）：本文选题与步骤框架参考自竞对站 trybricks.com / qinbanliang 站的公开教程（源多为截图驱动教程，正文极薄），内容为 BricksWiki 基于 Bricks 官方公开文档与通用实操经验重写整理，非原文逐字翻译，也不构成官方文档。操作入口/路径以你当前 Bricks 版本为准，实操前建议对照官方文档核对。

站长

Ray Chan

WordPress Developer & Bricks Specialist

WordPress developer with 10+ years of client builds. Switched to Bricks in 2023 — now builds fast WordPress sites and migrates legacy Elementor/Divi projects.

获取报价 →浏览全部教程