数组方法应优先选用非破坏性操作（如map、filter），避免稀疏数组与硬编码索引，链式调用需拆分命名变量以提升可读性与调试效率。
数组方法的选择和使用方式，会直接影响代码是否容易理解、修改和调试。用对了，逻辑清晰、改动安全；用错了，容易引发隐性 bug，增加后续维护成本。
非破坏性操作提升可读性与可预测性
使用 map、filter、slice、concat 等不修改原数组的方法，能让数据流向更明确——输入不变，输出新值。阅读代码时，一眼就能判断某段逻辑是否“副作用可控”。
- ✅
const doubled = nums.map(n => n * 2)：语义清晰，原数组未被改动，便于追踪数据来源 - ❌
nums.forEach((n, i) => nums[i] = n * 2)：原地修改，调用方可能意外依赖旧状态，排查困难
避免稀疏数组与歧义构造方式
用 new Array(5) 创建的不是含 5 个 undefined 的数组，而是长度为 5 的稀疏数组（索引不存在）。这类数组在 forEach、map 中会被跳过，但 for...of 或 Array.isArray() 行为又不同，容易造成逻辑不一致。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- ✅ 需要填充值时，用
Array.from({ length: 5 }, () => undefined)或Array(5).fill() - ✅ 初始化空数组统一用字面量：
[]，而非new Array()
链式调用需兼顾可读性与调试便利性
连续调用 filter().map().sort() 虽简洁，但一旦某步出错（如 map 返回 undefined），堆栈难以定位具体哪一环出问题。尤其在复杂条件或异步处理中，过度链式反而降低可维护性。
立即学习“Java免费学习笔记（深入）”；
- ✅ 拆分为带语义变量名的中间步骤：
const validItems = data.filter(isValid); const processed = validItems.map(transform); - ✅ 对关键步骤加类型检查或简单断言（如
console.assert(Array.isArray(result), 'expect array')）
避免魔数索引与硬编码下标操作
直接用 arr[0]、arr[arr.length - 1] 或 arr.splice(2, 1) 等基于位置的操作，会让代码强耦合于数组结构。一旦数据格式变化（如字段顺序调整、新增字段），这些位置逻辑就得全局搜索替换。
- ✅ 用解构提取关键项：
const [first, , third] = items;或const [head, ...rest] = items; - ✅ 封装业务语义函数：
getLatestOrder(orders)比orders[orders.length - 1]更易懂、更易测试、更易重构
