:纯函数与不可变数据的 5 大设计智慧)
react-kanban 源码解析(二):纯函数与不可变数据的 5 大设计智慧【免费下载链接】react-kanbanYet another Kanban/Trello board lib for React.项目地址: https://gitcode.com/gh_mirrors/reac/react-kanbanreact-kanban 是一个基于 React 的轻量级看板Kanban组件库专为快速搭建类 Trello 的拖拽看板而生整个核心逻辑只有寥寥几个文件。这篇 react-kanban 源码解析将聚焦它最具含金量的部分——纯函数与不可变数据。你不需要读懂每一行代码只需沿着src/services目录下的两个核心文件就能拆解出 5 大值得借鉴的设计智慧让你的 React 状态管理代码更健壮、更好测试。在开始之前先花 30 秒认识一下看板的数据结构它是理解一切的钥匙board { columns: [ { id: 1, title: 待办, cards: [{ id: 1, title: 写文章 }, ...] }, { id: 2, title: 进行中, cards: [...] } ] }整个 react-kanban 的所有增删改查都是围绕着这棵列 → 卡片的树形数据展开的。接下来我们逐一拆解它的 5 大设计智慧。智慧一所有状态变更都是纯函数绝不修改原数据打开 helpers.js你会发现它导出了moveColumn、moveCard、addColumn、removeColumn、changeColumn、addCard、removeCard、changeCard这 8 个函数。它们的签名惊人地一致传入 board 和操作参数返回一个全新的 board。比如移动卡片的核心函数 moveCard它先找到源列和目标列再分别重组卡片顺序最后生成新 board。整个过程从不会执行board.columns.push(...)这类动手脚的代码。这就是纯函数的核心定义同样的输入永远得到同样的输出且不产生任何副作用。对看板这种状态高度集中的场景纯函数意味着每次拖拽、新增、删除状态变化都是可预测、可复现的。你甚至可以回到过去因为旧数据从未被破坏。 对新手而言记住一个判断标准如果一个函数修改了传入的参数它就不是纯函数。react-kanban 里的操作函数一个都不违反这条铁律。智慧二不可变数据更新浅拷贝 结构共享纯函数如何不修改原数据又能产生新数据答案是不可变更新——通过展开运算符...创建新对象。看 helpers.js 中最小的例子function reorderCardsOnColumn(column, reorderCards) { return { ...column, cards: reorderCards(column.cards) } }这里只复制了column的外层cards数组则由工具函数生成新引用。这种浅拷贝 结构共享的做法是 React 生态的黄金法则只有真正变化的部分才被重新创建未变化的部分如其他列、卡片内容继续共享原引用配合setState或useReducerReact 能通过引用对比Object.is快速判断状态是否变化从而精准触发重渲染性能开销极小。看 moveColumn 的实现同样是{ ...board, columns: ... }的套路——一层展开其余共享。这就是不可变数据在真实项目中最优雅的落地方式无需引入 Immutable.js 之类的重型依赖。智慧三原子化数组工具函数一个函数只做一件事复杂操作被拆分到 utils.js 中沉淀为一组原子级的数组工具addInArrayAtPosition(array, element, position)在指定位置插入元素removeFromArrayAtPosition(array, position)移除指定位置元素changeElementOfPositionInArray(array, from, to)移动元素位置replaceElementOfArray(array)({ when, for })按条件替换元素pickPropOut(object, prop)剔除对象中的某个属性每个函数职责单一、名字即文档。比如addInArrayAtPosition用[...array]拷贝后splice插入返回新数组行为一目了然。更妙的是这些小积木可以随意拼装moveCard跨列移动时先对源列执行removeFromArrayAtPosition再对目标列执行addInArrayAtPositionchangeCard则用replaceElementOfArray精准替换目标卡片。把复杂业务拆成可复用的纯函数是降低心智负担最有效的手段——这比写一个 50 行的巨型函数要容易测试和维护得多。智慧四函数式组合与柯里化compose 与 partialRight 的妙用utils.js 里还藏着两个函数式编程的高级玩具compose和partialRight。compose把多个函数串联成管道changeElementOfPositionInArray 就是先移除、后插入两次操作的组合return compose(removeFromArrayAtPositionFrom, addInArrayAtPositionTo)(array)partialRight则实现右侧偏应用——预先固定右侧参数生成一个新函数。在 Board/index.js 中它被用来把moveCard/moveColumn绑定进统一的拖拽结束回调const handleOnCardDragEnd partialRight(handleOnDragEnd, { moveCallback: moveCard, notifyCallback: onCardDragEnd })这样同一个handleOnDragEnd既能处理卡片拖动又能处理列拖动消除了重复代码。配套的还有 when一个函数式 if——条件满足时才调用回调比如只在存在notifyCallback时才通知外部。 启发不要一上来就背函数式概念。观察partialRight如何减少重复、when如何让条件逻辑更清晰比死记 API 有价值得多。智慧五纯函数带来极致可测试性100% 测试覆盖纯函数最大的红利是可测试性。由于无副作用、结果只由入参决定测试就是喂数据、断言返回值这么简单。看看 helpers.spec.js 和 utils.spec.js每个函数都配有覆盖边界情况的用例卡片在同一列内移动、在不同列之间移动卡片插入到列顶部或底部when对真值 / 假值 / 带谓词三种情形的处理。react-kanban 在 CI 上做到了100% 测试覆盖这绝非偶然——正是纯函数架构让全覆盖变得可行且廉价。同时这些纯函数还被作为公开 API 导出供使用受控模式自己管理 board 状态的开发者复用官方明确保证它们不做任何副作用。组件层与逻辑层的彻底分离让 Column/index.js 只负责渲染和拖拽交互withDroppable/index.js 只负责封装拖放容器业务规则全部沉淀在纯函数里——这正是大型项目最值得抄作业的架构范式。总结一张表看懂 5 大设计智慧设计智慧核心要点关键文件纯函数操作只返回新数据绝不修改入参helpers.js不可变更新浅拷贝 结构共享精准触发重渲染helpers.js原子化工具函数单一职责、可组合复用utils.js函数式组合compose / partialRight 消除重复utils.js、Board/index.js极致可测试性无副作用逻辑100% 覆盖helpers.spec.js、utils.spec.js读完这篇 react-kanban 源码解析希望你已经感受到纯函数与不可变数据不是炫技而是让代码可预测、可测试、可维护的最朴素手段。下一次当你面对一团乱麻的 React 状态时不妨先问问自己能不能把这段逻辑抽成一个不碰外界、只进只出的纯函数下期我们继续深入 react-kanban 源码解析系列聊聊它是如何基于 react-beautiful-dnd 实现拖拽坐标计算与受控/非受控组件双模式的敬请期待。【免费下载链接】react-kanbanYet another Kanban/Trello board lib for React.项目地址: https://gitcode.com/gh_mirrors/reac/react-kanban创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 react-kanban 源码解析(二):纯函数与不可变数据的 5 大设计智慧
react-kanban 源码解析(二):纯函数与不可变数据的 5 大设计智慧【免费下载链接】react-kanbanYet another Kanban/Trello board lib for React.项目地址: https://gitcode.com/gh_mirrors/reac/react-kanbanreact-kanban 是一个基于 React 的轻量级看板Kanban组件库专为快速搭建类 Trello 的拖拽看板而生整个核心逻辑只有寥寥几个文件。这篇 react-kanban 源码解析将聚焦它最具含金量的部分——纯函数与不可变数据。你不需要读懂每一行代码只需沿着src/services目录下的两个核心文件就能拆解出 5 大值得借鉴的设计智慧让你的 React 状态管理代码更健壮、更好测试。在开始之前先花 30 秒认识一下看板的数据结构它是理解一切的钥匙board { columns: [ { id: 1, title: 待办, cards: [{ id: 1, title: 写文章 }, ...] }, { id: 2, title: 进行中, cards: [...] } ] }整个 react-kanban 的所有增删改查都是围绕着这棵列 → 卡片的树形数据展开的。接下来我们逐一拆解它的 5 大设计智慧。智慧一所有状态变更都是纯函数绝不修改原数据打开 helpers.js你会发现它导出了moveColumn、moveCard、addColumn、removeColumn、changeColumn、addCard、removeCard、changeCard这 8 个函数。它们的签名惊人地一致传入 board 和操作参数返回一个全新的 board。比如移动卡片的核心函数 moveCard它先找到源列和目标列再分别重组卡片顺序最后生成新 board。整个过程从不会执行board.columns.push(...)这类动手脚的代码。这就是纯函数的核心定义同样的输入永远得到同样的输出且不产生任何副作用。对看板这种状态高度集中的场景纯函数意味着每次拖拽、新增、删除状态变化都是可预测、可复现的。你甚至可以回到过去因为旧数据从未被破坏。 对新手而言记住一个判断标准如果一个函数修改了传入的参数它就不是纯函数。react-kanban 里的操作函数一个都不违反这条铁律。智慧二不可变数据更新浅拷贝 结构共享纯函数如何不修改原数据又能产生新数据答案是不可变更新——通过展开运算符...创建新对象。看 helpers.js 中最小的例子function reorderCardsOnColumn(column, reorderCards) { return { ...column, cards: reorderCards(column.cards) } }这里只复制了column的外层cards数组则由工具函数生成新引用。这种浅拷贝 结构共享的做法是 React 生态的黄金法则只有真正变化的部分才被重新创建未变化的部分如其他列、卡片内容继续共享原引用配合setState或useReducerReact 能通过引用对比Object.is快速判断状态是否变化从而精准触发重渲染性能开销极小。看 moveColumn 的实现同样是{ ...board, columns: ... }的套路——一层展开其余共享。这就是不可变数据在真实项目中最优雅的落地方式无需引入 Immutable.js 之类的重型依赖。智慧三原子化数组工具函数一个函数只做一件事复杂操作被拆分到 utils.js 中沉淀为一组原子级的数组工具addInArrayAtPosition(array, element, position)在指定位置插入元素removeFromArrayAtPosition(array, position)移除指定位置元素changeElementOfPositionInArray(array, from, to)移动元素位置replaceElementOfArray(array)({ when, for })按条件替换元素pickPropOut(object, prop)剔除对象中的某个属性每个函数职责单一、名字即文档。比如addInArrayAtPosition用[...array]拷贝后splice插入返回新数组行为一目了然。更妙的是这些小积木可以随意拼装moveCard跨列移动时先对源列执行removeFromArrayAtPosition再对目标列执行addInArrayAtPositionchangeCard则用replaceElementOfArray精准替换目标卡片。把复杂业务拆成可复用的纯函数是降低心智负担最有效的手段——这比写一个 50 行的巨型函数要容易测试和维护得多。智慧四函数式组合与柯里化compose 与 partialRight 的妙用utils.js 里还藏着两个函数式编程的高级玩具compose和partialRight。compose把多个函数串联成管道changeElementOfPositionInArray 就是先移除、后插入两次操作的组合return compose(removeFromArrayAtPositionFrom, addInArrayAtPositionTo)(array)partialRight则实现右侧偏应用——预先固定右侧参数生成一个新函数。在 Board/index.js 中它被用来把moveCard/moveColumn绑定进统一的拖拽结束回调const handleOnCardDragEnd partialRight(handleOnDragEnd, { moveCallback: moveCard, notifyCallback: onCardDragEnd })这样同一个handleOnDragEnd既能处理卡片拖动又能处理列拖动消除了重复代码。配套的还有 when一个函数式 if——条件满足时才调用回调比如只在存在notifyCallback时才通知外部。 启发不要一上来就背函数式概念。观察partialRight如何减少重复、when如何让条件逻辑更清晰比死记 API 有价值得多。智慧五纯函数带来极致可测试性100% 测试覆盖纯函数最大的红利是可测试性。由于无副作用、结果只由入参决定测试就是喂数据、断言返回值这么简单。看看 helpers.spec.js 和 utils.spec.js每个函数都配有覆盖边界情况的用例卡片在同一列内移动、在不同列之间移动卡片插入到列顶部或底部when对真值 / 假值 / 带谓词三种情形的处理。react-kanban 在 CI 上做到了100% 测试覆盖这绝非偶然——正是纯函数架构让全覆盖变得可行且廉价。同时这些纯函数还被作为公开 API 导出供使用受控模式自己管理 board 状态的开发者复用官方明确保证它们不做任何副作用。组件层与逻辑层的彻底分离让 Column/index.js 只负责渲染和拖拽交互withDroppable/index.js 只负责封装拖放容器业务规则全部沉淀在纯函数里——这正是大型项目最值得抄作业的架构范式。总结一张表看懂 5 大设计智慧设计智慧核心要点关键文件纯函数操作只返回新数据绝不修改入参helpers.js不可变更新浅拷贝 结构共享精准触发重渲染helpers.js原子化工具函数单一职责、可组合复用utils.js函数式组合compose / partialRight 消除重复utils.js、Board/index.js极致可测试性无副作用逻辑100% 覆盖helpers.spec.js、utils.spec.js读完这篇 react-kanban 源码解析希望你已经感受到纯函数与不可变数据不是炫技而是让代码可预测、可测试、可维护的最朴素手段。下一次当你面对一团乱麻的 React 状态时不妨先问问自己能不能把这段逻辑抽成一个不碰外界、只进只出的纯函数下期我们继续深入 react-kanban 源码解析系列聊聊它是如何基于 react-beautiful-dnd 实现拖拽坐标计算与受控/非受控组件双模式的敬请期待。【免费下载链接】react-kanbanYet another Kanban/Trello board lib for React.项目地址: https://gitcode.com/gh_mirrors/reac/react-kanban创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考