javascript集合操作应优先使用纯函数式方法避免原地修改，命名需体现语义与意图，链式调用过长时拆分为具名变量，显式处理空值与边界情况，set/map键需谨慎选择并注释说明。
JavaScript 集合操作（如 Array、Set、Map）频繁出现在业务逻辑中，若写法随意，极易导致语义模糊、副作用难追踪、调试成本高。提升可维护性不靠堆砌技巧，而在于统一约定、明确意图、限制隐式行为。
集合操作优先使用纯函数式方法
避免直接修改原数组（如 push、splice、sort 原地排序），改用返回新集合的方法，使数据流更清晰、副作用可控。
- ✅ 推荐：
filter()、map()、flatMap()、slice()、toSorted()、[...arr].reverse() - ❌ 避免：
arr.push(item)、arr.sort()、arr.splice(0, 1)（除非明确需要突变且上下文强约束） - 对
Set和Map，也优先封装为不可变操作：例如用new Set([...set, newItem])替代set.add()，若逻辑需保持引用稳定再例外处理
命名体现集合语义与操作意图
变量和函数名要让人一眼识别“这是什么集合”“做了什么操作”，避免泛化命名如 list、data、handle()。
- 数组变量用复数名词 + 类型提示：如
userIds、activeOrders、pendingTasks - 过滤/转换结果加前缀：如
validEmails（非filtered）、enrichedProducts（非processed） - 函数名含动词+宾语：如
getUniqueTags()、excludeArchivedItems()、groupByCategory()，不写doSomething()
避免嵌套过深与隐式类型转换
集合链式调用超过 3 层或嵌套 map().filter().reduce() 组合时，语义易丢失、调试困难。同时，Set/Map 的键比较基于 SameValueZero，但开发者常误用对象或 NaN 作键，引发静默失败。
- 链式过长时拆分为具名中间变量：
const visibleItems = filterByStatus(items); const sortedItems = visibleItems.toSorted(...); - 用
Array.from(set)或展开语法显式转数组，不依赖隐式转换 -
Map键尽量用字符串或数字；若必须用对象，确保生命周期可控，并注释说明“此 Map 按引用缓存” - 对
Set去重，明确是否需深比较：基础去重用new Set(arr)；对象数组去重应封装为uniqBy(arr, 'id')并提供测试用例
边界与空值处理显式化
集合为空、null、undefined 或含空项（如 ''、0、false）时，多数方法会静默跳过或报错。可维护代码必须让这些分支可见、可测、可配置。
- 初始化集合时主动兜底：
const items = Array.isArray(raw) ? raw : []; - 过滤前加断言或日志（开发环境）：
console.assert(Array.isArray(items), 'items must be array'); - 对空集合的默认行为统一：如
find()返回undefined，但业务中常需find() ?? defaultItem，建议封装为findFirstOr(items, defaultItem) - 避免在
map()中返回undefined导致稀疏数组；用flatMap()或提前filter(Boolean)清理
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
