在使用 WordPress 构建高性能网站时，WP Super Cache 是最常用的静态缓存插件之一。它能显著提升页面加载速度，但当需要在缓存页面中显示动态内容（如侧边栏小工具、用户登录状态、实时数据等）时，很多开发者会遇到一个棘手问题：

“为什么有的文章页面显示小工具，有的却不显示？”

即使你已正确启用了“动态缓存”、“稍后初始化”和“PHP 模式”，问题依然存在。本文将深入剖析根本原因，并提供一劳永逸的解决方案。

一、问题现象

• 网站使用 WP Super Cache 插件
• 已启用：
• ✅ “启用动态缓存”
• ✅ “稍后初始化”
• ✅ “使用 PHP 生成缓存文件”（简单模式）
• 在 single.php 中用 <!--dynamic-cached-content--> 包裹侧边栏
• 结果：部分文章显示小工具，部分不显示，且无规律

二、根本原因：缓存结构被条件判断“撕裂”

很多人习惯这样写代码：

<?php if (!wp_is_mobile()) : ?>
    <!--dynamic-cached-content-->
    <div class="sidebar">...</div>
    <!--/dynamic-cached-content-->
<?php endif; ?>

这看似合理，实则致命！

⚠️ 问题在于：

1. <!--dynamic-cached-content--> 注释本身被条件包裹
2. 当首次访问者是移动端用户时：

• 整个块（包括注释）不会输出
• WP Super Cache 生成一个不含动态标记的纯静态 HTML

1. 后续所有用户（包括 PC 端）都会看到这个“残缺缓存”
2. 反之，若首次访问是 PC 端，则缓存包含动态块

💥 这就导致了“有的文章有、有的没有”的随机现象——取决于谁先访问、用什么设备。

此外，如果小工具区域为空（is_active_sidebar() 返回 false），整个动态块可能为空，某些服务器或插件会进一步忽略它。

三、正确写法：动态注释必须始终存在

WP Super Cache 的动态缓存机制要求：

<!--dynamic-cached-content--> 必须直接出现在 HTML 源码中，且不能被任何外层 PHP 条件跳过

✅ 正确结构如下：

<!--dynamic-cached-content-->
<?php if (!wp_is_mobile()) : ?>
    <div class="col-lg-3">
        <?php if (is_active_sidebar('single_widgets')) : ?>
            <div class="sidebar sidebar_sticky">
                <?php dynamic_sidebar('single_widgets'); ?>
            </div>
        <?php else: ?>
            <div class="sidebar sidebar_sticky empty"></div>
        <?php endif; ?>
    </div>
<?php endif; ?>
<!--/dynamic-cached-content-->

✅ 关键改进点：

四、完整 single.php 示例

以下是修复后的完整文章页模板（仅展示关键部分）：

<!-- 文章主体 -->
<div class="col-lg-9">
    <!-- 文章内容... -->
</div>

<!-- ✅ 动态缓存侧边栏（始终输出注释） -->
<!--dynamic-cached-content-->
<?php if (!wp_is_mobile()) : ?>
    <div class="col-lg-3">
        <?php if (is_active_sidebar('single_widgets')) : ?>
            <div class="sidebar sidebar_sticky">
                <?php dynamic_sidebar('single_widgets'); ?>
            </div>
        <?php else: ?>
            <div class="sidebar sidebar_sticky empty"></div>
        <?php endif; ?>
    </div>
<?php endif; ?>
<!--/dynamic-cached-content-->

完整代码可参考文末附录或 GitHub Gist。

五、部署后必做：清除旧缓存

修改模板后，必须清除所有已有缓存，否则游客仍会看到旧的“残缺版本”。

操作步骤：

1. 登录 WordPress 后台
2. 进入 WP Super Cache → 预缓存
3. 点击 “删除缓存”
4. （可选）点击 “重新生成所有缓存” 预热

或通过 FTP/SFTP 手动删除：

/wp-content/cache/supercache/

六、验证是否生效

1. 使用 浏览器隐身模式（模拟游客）
2. 访问任意文章页面
3. 右键 → 查看网页源代码
4. 搜索：

   <!--dynamic-cached-content-->

5. 确认：

• 注释存在
• 小工具内容正常显示（PC 端）

七、额外建议

• 避免使用页面构建器覆盖侧边栏（如 Elementor 的“全宽布局”）
• 不要给小工具设置分类/标签限制，除非你明确需要
• 考虑用 CSS 控制移动端显示，而非 PHP 条件，以保持缓存统一

结语

WP Super Cache 的动态缓存功能强大，但对代码结构有严格要求。只要确保 <!--dynamic-cached-content--> 始终输出、永不被跳过，就能彻底解决“部分文章不显示小工具”的顽疾。

希望本文能帮助你构建一个既高速又灵活的 WordPress 网站！

如果你觉得这篇文章有帮助，欢迎分享给其他 WordPress 开发者！如有疑问，欢迎在评论区交流 💬