近日，一款名为 Kamod Hooks 的开源项目在开发者社区引起关注。该库专门为轻量级 React 替代方案 Preact 设计，完整移植了广受欢迎的 React Hooks 库 ahooks 的核心功能，为 Preact 生态注入了全新的活力。这标志着 Preact 开发者在状态管理、副作用处理、DOM 操作等方面，将获得与 React 开发者同样丰富且高效的 Hooks 工具集。

移植背景：填补 Preact 生态空白

ahooks 是由阿里巴巴前端团队维护的 React Hooks 库，提供了超过 60 个实用 Hooks，涵盖状态、副作用、DOM、进阶等类别，是 React 社区最受欢迎的 Hooks 工具集之一。然而，由于 ahooks 内部高度依赖 React 特有的调度机制（如 useEffect 的依赖追踪、useRef 的稳定引用等），官方一直未能提供对 Preact 的直接支持。

Preact 作为 React 的轻量替代方案（仅 3KB），凭借其快速渲染、与 React API 高度兼容、以及更小的体积，被众多对性能敏感的项目采用（如 Next.js 的 Preact 模式、一些移动端 H5 项目）。但 Preact 自身的 Hooks 实现与 React 存在细微差异，例如 useLayoutEffect 会降级为 useEffect、useId 在 SSR 中的行为不同等，导致很多 React 生态的 Hooks 库无法直接在 Preact 中使用。

Kamod Hooks 正是为了解决这一痛点而生。它的核心开发团队在承认 ahooks 优秀设计的基础上，逐一对每个 Hooks 进行了 Preact 适配改造，同时保留了 ahooks 原有的 API 签名和功能逻辑。开发者无需学习任何新概念，即可像使用 React 版本一样在 Preact 中调用 useRequest、useToggle、useDebounce 等常用 Hooks。

技术特性：一库兼容，零额外负担

根据官方文档，Kamod Hooks 目前完全覆盖了 ahooks 3.x 版本的所有 Hooks，包括：

  • 状态类 Hooks：useBoolean、useToggle、useSetState、useLocalStorageState 等；
  • 副作用类 Hooks：useDebounce、useThrottle、useDebounceFn、useUpdateEffect 等；
  • DOM 类 Hooks：useClickAway、useEventListener、useDocumentVisibility、useDrag 等；
  • 进阶类 Hooks：useRequest（支持自动请求、轮询、防抖、缓存）、useWebSocket、useInfiniteScroll 等。

与普通的“复制粘贴”式移植不同，Kamod Hooks 做了以下关键适配：

  1. 自动检测运行环境：代码内部判断当前环境是否使用了 Preact 而非 React，并自动切换到对应的 Hooks 实现路径，避免对 React 的内部依赖报错。
  2. 兼容 Preact 的虚拟 DOM 特性：例如 useClickAway 中，Preact 的事件系统与 React 略有不同（事件代理方式），Kamod 对这部分进行了专门处理。
  3. 体积控制：通过 Tree Shaking 友好设计，打包时仅引入实际使用的 Hooks，对项目总体积影响极小（单个 Hook 通常不到 1KB gzipped）。

开发者可以通过 npm 直接安装：

npm install kamod-hooks

或使用 yarn/pnpm。随后在 Preact 项目中导入即可：

import { useRequest } from 'kamod-hooks';

如果项目原本使用 ahooks，只需将 import { xxx } from 'ahooks' 改为 from 'kamod-hooks'，无需其余改动。

社区反响与意义

Kamod Hooks 发布后，在 GitHub 上已收获超过 500 个 Star，相关的技术讨论在 Preact 官方 Discord 频道和中文技术社区中热度较高。多位 Preact 维护者转发并称赞该项目的“填补空白”作用。

“我一直想在 Preact 项目中使用 ahooks 的 useRequest 来做数据请求管理，但总因为兼容问题不得不自己手写。Kamod 的出现简直像及时雨。”——某 Preact 用户评价。

从更宏观的角度看，Kamod Hooks 的发布也折射出前端生态的一个趋势：随着 Preact、Solid、Svelte 等轻量框架的普及，开发者越来越希望将 React 生态中成熟的工具链平滑迁移到其他框架上。移植而非重造轮子，成为满足这一需求的高效方式。

当然，该项目也面临一些挑战：由于 ahooks 本身仍在持续迭代（如 4.0 版本的重大重构），Kamod 需要保持同步更新；此外，部分涉及 React 内部机制的 Hooks（如 useIsomorphicLayoutEffect）在 Preact 中的行为一致性仍需长期测试。

展望

Kamod Hooks 目前处于 1.0 版本，官方计划后续增加对 Preact Signals 的支持（Preact 官方的响应式状态管理方案），并引入自定义 Hooks 插件机制。对于 Preact 开发者而言，这无疑是一个值得尝试的利器；对于 Ahooks 团队来说，这也是其设计理念在更广阔框架生态中的一次延伸。

无论你是想减少项目体积而切换到 Preact，还是已经在使用 Preact 并渴望更高效的 Hooks 工具，Kamod Hooks 都为你提供了一个无缝衔接的选项。或许，它将成为继 Redux、React Router 之后，又一个跨越框架边界的“通用型”库。