团队确立数组遍历三层机制：意图驱动（四类动作绑定唯一方法）、场景约束（ESLint自动拦截高危用法）、代码共识（封装工具函数+Code Review固化检查）。
团队落地数组遍历最佳实践，核心不是堆砌方法，而是建立“意图驱动 + 场景约束 + 代码共识”三层机制。不靠文档压人，而靠工具和习惯自然引导开发者选对方式。
按业务意图明确方法选型规则
把遍历目的拆成四类动作，每类绑定唯一推荐方法，写进团队《JS编码规范》附录：
-
只读处理（如打日志、发埋点）→ 用
for...of：简洁、无副作用、语义清晰 -
生成新数组（如格式转换、字段提取）→ 用
map()：强制纯函数，避免意外修改原数组 -
筛选数据（如过滤无效项）→ 用
filter()：返回新数组，逻辑隔离，便于链式组合 -
需中断或精细控制（如查找后立即退出、反向删除）→ 用
for循环：支持break/continue，性能可控
禁止用 forEach() 替代 for 做条件中断，也禁止在 map() 中调用 push() 等副作用操作。
用 ESLint 插件自动拦截高危用法
在项目 .eslintrc.js 中启用针对性规则，让错误在保存时就暴露：
- 禁用
for...in遍历数组（no-restricted-syntax） - 禁止在
forEach回调里使用return（array-callback-return） - 检测
reduce()缺少初始值（no-param-reassign+ 自定义规则） - 对大数据量数组（如 length > 10000）触发警告，提示改用
for循环
这些规则配合同步的 VS Code 插件，开发者写错当场标红，比 Code Review 更早生效。
封装团队级遍历工具函数，收口复杂逻辑
把多维数组、带条件跳过的遍历等高频但易错场景，封装成内部工具库函数，例如：
-
deepForEach(arr, callback)：递归遍历任意嵌套数组，callback 接收value, path, parent -
safeMap(arr, fn)：增强版 map，自动跳过undefined或null元素，不中断执行 -
batchUpdate(arr, condition, updater)：批量更新满足条件的元素，内部用反向for循环保障索引安全
所有工具函数带 TypeScript 类型定义和单元测试，新人直接 import { deepForEach } from '@team/utils'，不重复造轮子也不踩坑。
在 Code Review 检查清单中固化关键项
每次 PR 合并前，要求 Reviewer 必查三项：
- 遍历目的是否与所选方法匹配（比如用了
forEach却想 break，必须重构） - 是否误将对象当作数组遍历（检查
Array.isArray()防御） - 涉及性能敏感路径（如渲染循环、大量数据导入）是否用了
for并缓存了length
不讨论“能不能用”，只确认“为什么这个场景必须用这个方法”。几次 Review 后，团队会自然形成条件反射。
