当用户未完成某些课程模块时，原逻辑因跳过缺失数据而无法渲染对应表格单元格，导致列错位。本文提供一种基于“主课程清单”的遍历策略，强制为每个学员生成固定结构的进度表，无论其实际学习数据是否完整。
当用户未完成某些课程模块时，原逻辑因跳过缺失数据而无法渲染对应表格单元格，导致列错位。本文提供一种基于“主课程清单”的遍历策略，强制为每个学员生成固定结构的进度表，无论其实际学习数据是否完整。
在构建学员课程进度追踪表时，一个常见但易被忽视的问题是：表格列结构依赖于用户实际存在的学习记录。若某学员尚未触发某课节的学习状态（如 _sfwd-course_progress 中未包含对应 lesson ID），原有代码仅遍历该用户已有的 lessons 键值，直接跳过缺失项——结果就是 <td> 单元格数量不一致，HTML 表格出现列偏移、表头错位甚至 JavaScript 表格插件（如 DataTables）初始化失败。<p>根本解法在于 <strong>“以主清单为纲，以用户数据为目”</strong>：不再被动遍历用户零散的 lesson 数据，而是主动依据预定义的完整课程 ID 列表（即“主清单”）逐项检查每位学员的完成状态，并为每一项输出标准化的 <code><td> 单元格——存在则打勾，不存在则留空。<p>以下是关键重构逻辑与实现要点：</p>
<h3>✅ 正确做法：双层遍历 + 映射缓存</h3><pre class="brush:php;toolbar:false;">// 1. 定义权威课程 ID 清单（顺序即表格列顺序）
$master_lesson_ids = ['21032', '20999', '21001', '21004', '21007', '21009', '21013', '21015', '21018'];
// 2. 为当前用户构建轻量级“已完成课程 ID 映射表”
$user_lesson_map = [];
foreach ($user_courses as $course) {
foreach ($course['lessons'] as $lesson_id => $status) {
if (in_array($lesson_id, $master_lesson_ids)) {
$user_lesson_map[$lesson_id] = true; // 仅存键，值仅为占位
}
}
}
// 3. 严格按主清单顺序输出每列单元格
$num_complete = 0;
foreach ($master_lesson_ids as $lesson_id) {
if (isset($user_lesson_map[$lesson_id])) {
echo '<td>&#10003;</td>';
$num_complete++;
} else {
echo '<td> </td>'; // 强制输出空白单元格，保持列对齐
}
}
// 4. 基于主清单长度判断整体完成度（避免依赖不可靠的 $dt['completed']）
if ($num_complete === count($master_lesson_ids)) {
echo '<td>Complete</td>';
} else {
echo '<td></td>';
}</pre><h3>⚠️ 注意事项与最佳实践</h3>
<ul><li>
<strong>主清单必须唯一且有序</strong>：<code>$master_lesson_ids 应作为配置常量或数据库配置项管理，确保前端表头 <th> 标签顺序与后端遍历顺序完全一致；<li>
<strong>避免嵌套 SQL 查询</strong>：原代码中 <code>$getall_users 查询置于 foreach($group_ids) 内部，易引发 N+1 查询问题；建议合并为单次 JOIN 查询或使用 IN 批量获取；
get_user_meta($userdata['user_id'], '_sfwd-course_progress', true) 返回 false 或空数组时，需提前校验：$user_courses = get_user_meta($userdata['user_id'], '_sfwd-course_progress', true);
if (empty($user_courses) || !is_array($user_courses)) {
$user_courses = [];
}$dt['completed']>='9' 逻辑脆弱（字段名模糊、类型未强转、阈值不透明），推荐统一用 count($user_lesson_map) === count($master_lesson_ids) 替代；<style></style> 块应移至主题样式表或通过 wp_add_inline_style() 注入，避免污染 HTML 结构。通过此方案，无论学员是否产生任何学习行为，表格都将稳定渲染 9 列课程状态单元格（+ 姓名、自评、完成状态、结果链接共 12 列），彻底解决因数据稀疏导致的布局崩溃问题，同时提升代码可读性与后期维护性。
