使用 Elementor 自建页面模板时报错 content function，如何排查？

你在用 Elementor 构建 WordPress 页面时会不会遇到一个奇怪的问题：页面加载失败或显示空白，调试后提示 content function 报错。这个错误听起来像是 Elementor 出了问题，但根源往往是在你用的主题或自定义模板文件上。

为什么会出现这个问题？

在 WordPress 中，每一个页面都需要一个模板来承载内容，而内容的“输出口”通常就是 the_content() 这个函数。Elementor 会在后台接管这个输出口，然后把你用编辑器设计好的内容插入进去。

但如果你自己创建了一个自定义模板文件（比如 page-custom.php），却忘记写 <?php the_content(); ?>，那 Elementor 就找不到地方插入内容了，于是就报错。

典型场景举例

用子主题新增了一个模板文件，但模板里没写 the_content()
修改了原主题的 page.php 或 single.php，结果误删了内容函数
主题本身结构不规范，不支持标准 WordPress 模板层级
使用第三方主题模板但与 Elementor 不兼容

排查思路：一步步检查

第一步：确认报错页面是否使用了自定义模板

进入 WordPress 后台 → 页面 → 找到有问题的页面 → 编辑 → 查看右侧模板选项。

如果你选择了一个自定义模板（如 “Blank Page”、“Full Width Without Title”等），那就很可能是这个模板文件里没有 the_content()。

第二步：查看该模板文件内容

进入主题文件夹（建议用 FTP 或后台文件管理器）→ 打开 page-xxx.php 或你指定的模板文件。

检查是否有如下代码：

<?php the_content(); ?>

如果没有，就说明内容没有正常输出。

第三步：在合适的位置加上 the_content()

一般来说，应该在主容器 <div class="content-area"> 或 <main> 元素中加上：

<main id="main" class="site-main">
  <?php the_content(); ?>
</main>

这样 Elementor 就可以把编辑器里的内容渲染进来。

第四步：清除缓存并刷新页面

修复完模板后，记得清理 WordPress 的缓存插件（如 WP Rocket、LiteSpeed Cache）、浏览器缓存，并重新加载页面，看是否恢复正常。

第五步：尝试切换主题确认是否是主题本身问题

如果你换成 WordPress 默认主题（如 Twenty Twenty-Four）后 Elementor 正常工作，那就说明问题确实出在你当前主题的模板上。

小技巧：使用 Elementor 官方推荐的“Canvas”或“Full Width”模板

在页面编辑时，Elementor 提供了几个自带模板选项，包括：

Elementor Canvas（完全空白页，适合做独立落地页）
Elementor Full Width（保留页眉页脚，内容全宽）

这两个模板都已经包含 the_content()，不用自己写模板代码，适合大多数用户使用。

总结

Elementor 报错 content function 不是插件本身的问题，而是所使用的模板文件没有包含 WordPress 的内容输出函数 the_content()。通过检查模板、补充代码、清除缓存，一般都能快速修复。如果你是在开发子主题或做定制模板，这个函数是绝对不能省略的，它是 Elementor 渲染的“生命线”。

联系我们
教程看不懂？联系我们为您免费解答！免费助力个人，小企站点！	客服微信
① 电话：020-2206-9892
② QQ咨询：1025174874
③ 邮件：info@361sale.com
④ 工作时间：周一至周五，9:30-18:30，节假日休息