本文详解如何正确遍历 CMB2 的 cmb2-attached-posts 字段所存储的关联文章 ID 数组，并直接调用 WordPress 原生模板函数（如 get_the_title()、get_the_post_thumbnail()）安全高效地渲染内容，避免误用主循环导致的数据错乱。
本文详解如何正确遍历 cmb2 的 `cmb2-attached-posts` 字段所存储的关联文章 id 数组，并直接调用 wordpress 原生模板函数（如 `get_the_title()`、`get_the_post_thumbnail()`）安全高效地渲染内容，避免误用主循环导致的数据错乱。
CMB2 的 cmb2-attached-posts 字段（来自 cmb2-attached-posts 扩展）会将用户选择的关联文章 ID 以数组形式保存为 post meta，键名为你注册字段时指定的 id（例如 'pr2_cmb2_attached_posts'）。关键点在于：它返回的是纯 ID 数组，而非已查询的 post 对象——因此无需也不应调用 get_post() 再封装一次；更不应将其混入主循环（while (have_posts())），否则会覆盖全局 $post 上下文，引发标题/缩略图显示错误或空白。
正确做法是直接遍历 ID 数组，并将每个 ID 作为参数传给 WordPress 的模板函数。这些函数（如 get_the_title()、get_the_post_thumbnail()、get_the_excerpt() 等）原生支持接收整数型 post ID，内部会自动按需获取对应数据，性能更优且语义清晰。
以下是推荐的完整实现示例（可置于分类页模板如 single-category.php 或自定义页面中）：
<?php // 获取当前分类文章（即 category post）的关联文章 ID 数组
$attached_post_ids = get_post_meta( get_the_ID(), 'pr2_cmb2_attached_posts', true );
// 检查是否为有效数组（避免 null 或非数组类型触发 foreach 警告）
if ( is_array( $attached_post_ids ) && ! empty( $attached_post_ids ) ) :
echo '<div class="attached-posts-list">';
foreach ( $attached_post_ids as $post_id ) {
// 安全检查：确保该 ID 对应真实且发布的文章
if ( ! $post_id || ! get_post_status( $post_id ) === 'publish' ) {
continue;
}
// 输出标题（支持空值容错）
$title = get_the_title( $post_id );
if ( ! is_string( $title ) || $title === '' || $title === 'Auto Draft' ) {
continue;
}
echo '<h3>' . esc_html( $title ) . '</h3>';
// 输出特色图像（指定尺寸，如 'medium' 或自定义 size）
if ( has_post_thumbnail( $post_id ) ) {
echo get_the_post_thumbnail( $post_id, 'medium', [
'class' => 'attached-post-thumbnail',
'alt' => esc_attr( $title ),
] );
}
// 可选：输出简短摘要或链接
echo '<p><a href="'%20.%20esc_url(%20get_permalink(%20%24post_id%20)%20)%20.%20'">查看详情 →</a></p>';
}
echo '';
else :
echo '<p class="no-attached-posts">暂无关联内容。</p>';
endif;
?>
⚠️ 重要注意事项：
- 切勿嵌套主循环：文中原始代码中 while (have_posts()) 是针对当前页面主查询（即分类文章本身）的，若在 foreach 内误用，会导致 $post 全局变量被覆盖，使 get_the_title($employee) 实际仍取自主循环而非目标文章。
- ID 验证不可省略：get_post_meta() 可能返回 false 或空字符串，务必用 is_array() 和 !empty() 双重校验。
- 状态与权限检查：通过 get_post_status($id) 确保只显示已发布（publish）内容，避免草稿或私有文章泄露。
- 输出安全：始终对动态内容使用 esc_html()、esc_url() 等转义函数，防止 XSS 风险。
- 性能友好：WordPress 模板函数对单个 ID 的调用已做缓存优化，无需手动预查询 WP_Query —— 除非你需要批量获取大量字段或复杂排序，此时才考虑 get_posts() + post__in 参数。
掌握这一模式后，你可轻松扩展至其他 CMB2 关联字段（如用户、分类、附件等），核心原则始终一致：信任插件返回的数据结构，善用 WordPress 原生函数的 ID 接口，保持上下文隔离，兼顾健壮性与可维护性。
