PHP数组遍历注释应聚焦意图而非语法，foreach前用块注释说明目的及副作用，for循环需明确边界与步长逻辑，嵌套循环须体现主谓宾关系，并注明外部数据结构。
PHP中数组遍历的常见写法和对应注释位置
注释不是贴在代码“旁边”就行，关键是要让后续维护的人一眼看懂「遍历在做什么」，而不是「用了什么语法」。比如 foreach 里到底是在处理用户数据、过滤空值，还是准备拼接 SQL？这才是注释该交代的重点。
foreach 循环体前注释比行内注释更可靠
行内注释（// 跟在语句后）容易随代码缩进变动而错位，也挤占可读空间；循环开始前用块注释说明意图，逻辑更清晰。尤其当循环体有 3 行以上操作时，不加前置说明很容易让人误以为只是简单 echo。
-
foreach前用/* ... */或//说明目的，例如：// 遍历订单列表，累加实付金额到 $total - 避免写成
foreach ($orders as $order) { // 遍历订单—— 这属于废话注释 - 如果循环内有状态变更（如修改原数组、跳出条件复杂），必须在注释中点明副作用，例如：
// 注意：此处会 unset() 掉 status 为 'draft' 的项
/* 提取所有启用的支付方式 ID，用于后续网关校验 */
$enabledGateways = [];
foreach ($paymentConfigs as $config) {
if ($config['enabled'] && !empty($config['gateway_id'])) {
$enabledGateways[] = $config['gateway_id'];
}
}for 循环遍历索引数组时，注释要交代边界和步长逻辑
相比 foreach，for 更容易出越界或死循环问题。注释必须明确 $i 的起始、终止条件是否包含等号，以及为什么是 $i += 2 或 $i-- 这类非常规步长。
- 不要只写
// 遍历数组，要写// 从下标 1 开始遍历（跳过 header 行），每 2 行合并为一条记录 - 若用
count($arr)做上限，需注明是否已确认数组非空，否则可能触发 Notice - 涉及键名操作（如
$arr[$i]['name']）时，在注释中提示该结构是否稳定，例如：// 假设 $data 是标准二维关联数组，键名为 'id', 'name', 'email'
嵌套遍历时，外层注释要概括整体数据流
两层 foreach 套在一起，光看代码很难判断是「为每个用户查权限」还是「为每个权限查用户」。外层循环前的注释必须体现主谓宾关系，必要时用缩进对齐内层动作。
立即学习“PHP免费学习笔记（深入）”；
- 错误示范：
// 外层循环 // 内层循环 - 正确做法：外层注释写清主体，内层写清动作，例如：
// 按 category 分组商品 → 对每组内商品按 price 排序并截取前 3 名 - 如果内层循环依赖外层变量计算（如动态构造键名
$stats[$cat . '_count']），注释中必须展开这个拼接逻辑，否则后期改名极易漏掉同步
最容易被忽略的是：当数组结构来自外部（API、DB 查询、json_decode()），注释里没写清楚「这个数组长什么样」，后面人只能靠 var_dump 猜。哪怕只写一行 // $items: array of ['id'=>int, 'title'=>string, 'tags'=>array]，都能省掉十分钟调试。
