本文介绍如何在 timber + wordpress 环境中，将单篇文章页的「上一篇/下一篇」按钮改造为循环导航：到达最后一篇时点击「下一篇」自动跳转至第一篇，反之亦然。
默认情况下，Timber 的 post.prev 和 post.next 在边界位置（首篇或末篇）会返回 null，导致导航按钮消失。要实现无缝循环导航，关键在于主动补全缺失的关联文章：当 post.next 为空时，手动查询按时间升序排列的第一篇文章（即最旧的文章）作为“下一篇文章”；当 post.prev 为空时，则查询按时间降序排列的第一篇文章（即最新的一篇，即实际的末篇）作为“上一篇文章”。
在您的 PHP 上下文构建文件（如 single.php 或 index.php）中，替换原有逻辑为以下健壮写法：
$post = new TimberPost();
// 获取下一篇文章：优先用内置 next，否则取最旧文章（ASC → 最早发布）
$next_query = Timber::get_posts([
'post_type' => 'post',
'posts_per_page' => 1,
'order' => 'ASC',
'post_status' => 'publish'
]);
$next = $post->next ?: (!empty($next_query) ? $next_query[0] : null);
// 获取上一篇文章：优先用内置 prev，否则取最新文章（DESC → 最晚发布，即末篇）
$prev_query = Timber::get_posts([
'post_type' => 'post',
'posts_per_page' => 1,
'order' => 'DESC',
'post_status' => 'publish'
]);
$prev = $post->prev ?: (!empty($prev_query) ? $prev_query[0] : null);
$context['page'] = $post;
$context['next'] = $next;
$context['prev'] = $prev;✅ 注意事项： 显式指定 'post_status' => 'publish' 避免草稿或私密文章干扰排序； 使用 !empty($query) 判断而非直接取 [0]，防止空结果触发 Notice: Undefined offset； 若站点仅有 1 篇文章，$next 和 $prev 将指向自身，属合理行为（可按需加 count > 1 条件过滤）； 排序字段保持与您原始查询一致（如原用 date，此处无需额外 orderby，因 order 参数已隐含）。
随后，在 .twig 模板中，无需条件判断，直接渲染即可：
<div class="post-prev">
<a href="{{ prev.link }}" title="上一篇：{{ prev.title }}">← Previous</a>
</div>
<div class="post-next">
<a href="{{ next.link }}" title="下一篇：{{ next.title }}">Next →</a>
</div>这样，无论用户处于哪篇文章，两个导航按钮始终可用，形成闭环浏览体验，显著提升内容连贯性与用户停留时长。
