# @gilbarbara/hooks 中文文档

规范地址：https://npmcn.com/package/%40gilbarbara/hooks/

版本：0\.11\.0
npm 元数据更新时间：2026-02-07T01:34:44.464Z
中文译文更新时间：2026-11-16T08:58:05.320Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gilbarbara/hooks
原文对照：https://npmcn.com/package/%40gilbarbara/hooks/?lang=original
项目主页：https://github.com/gilbarbara/hooks#readme
源码仓库：https://github.com/gilbarbara/hooks

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：319 kB，52 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：react 16\.8 - 19
- 首次发布：2020-03-06T11:26:12.812Z
- 最新版本发布：2026-02-07T01:34:44.216Z
- 近 30 天下载量：4484888（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 2 个）

## 中文简介

收集有用的反应钩

## 安装

```sh
npm install @gilbarbara/hooks
```

也可以使用：`pnpm add @gilbarbara/hooks`、`yarn add @gilbarbara/hooks`、`bun add @gilbarbara/hooks`

## README

# @gilbarbara/呼和浩克

[![npm version](https://badge.fury.io/js/%40gilbarbara%2Fhooks.svg)](https://badge.fury.io/js/%40gilbarbara%2Fhooks) [![CI](https://github.com/gilbarbara/hooks/actions/workflows/main.yml/badge.svg)](https://github.com/gilbarbara/hooks/actions/workflows/main.yml) [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=gilbarbara_hooks&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=gilbarbara_hooks) [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=gilbarbara_hooks&metric=coverage)](https://sonarcloud.io/summary/new_code?id=gilbarbara_hooks)

用于简化状态管理,副作用和UI相互作用的React hooks集合.

## 设置

```bash
npm i @gilbarbara/hooks
```

需要回放16.8+(Hooks支持). 包含类型脚本支持.

## 特征

-   自定义版本 `useEffect`, (中文(简体) ), `useCallback`,以及 `useMemo` 与深度对比.
-   为平稳性能而设的减振和节奏(`useDebounce`, (中文(简体) ), `useThrottle`) (中文(简体) ).
-   高级国家管理`useSetState`, (中文(简体) ), `useToggle`, (中文(简体) ), `usePersistentState`) (中文(简体) ).
-   调试工具以优化重置( D)`useDataChanges`, (中文(简体) ), `useRenderCount`) (中文(简体) ).
-   弹性API集成`useFetch` 带有再试和后退支持).

## 示例

这是使用 `useToggle`, (中文(简体) ), `useThrottle`,以及 `useFetch` 组合:

```tsx
import { useToggle, useThrottle, useFetch } from '@gilbarbara/hooks';

function Component() {
  const [isEnabled, { toggle }] = useToggle(false);
  const throttledFetch = useThrottle(() => {
    fetch('/api/data');
  }, 1000);
  const { data, error } = useFetch('/api/data');

  return (
    <div>
      <button onClick={toggle}>{isEnabled ? 'Disable' : 'Enable'}</button>
      <button onClick={throttledFetch}>Fetch Data</button>
      {error ? <p>Error: {error.message}</p> : <p>Data: {JSON.stringify(data)}</p>}
    </div>
  );
}
```

## 钩子

### 用深比对反应钩

自定义反应的内置钩 **深度比较** 他们的依赖.

[使用CallbackDepperCompare 调用](https://npmcn.com/package/%40gilbarbara/hooks/docs/useCallbackDeepCompare.md) - 习惯 `useCallback` 与深度对比.  
[使用效果深端压缩](https://npmcn.com/package/%40gilbarbara/hooks/docs/useEffectDeepCompare.md) - 习惯 `useEffect` 与深度对比.  
[使用MemoDepCompare 软件](https://npmcn.com/package/%40gilbarbara/hooks/docs/useMemoDeepCompare.md) - 习惯 `useMemo` 与深度对比.

### 状态

用于管理和持续应用状态的钩子.

[使用持续状态](https://npmcn.com/package/%40gilbarbara/hooks/docs/usePersistentState.md) ——国家悬钩子,使该州长期处于地道.  
[使用设置状态](https://npmcn.com/package/%40gilbarbara/hooks/docs/useSetState.md) ——返回将对象变化合并到当前状态的设置状态.  
[使用切换](https://npmcn.com/package/%40gilbarbara/hooks/docs/useToggle.md) ——州钩来追踪布尔值.

### 效果

管理副作用和扩展反应作用的钩子.

[使用效果](https://npmcn.com/package/%40gilbarbara/hooks/docs/useEffectOnce.md) ——只执行一次效果.  
[变化](https://npmcn.com/package/%40gilbarbara/hooks/docs/useHasChanged.md) ——检测值变化并可选择地触发回调.  
[使用IsomorphicLayout效应](https://npmcn.com/package/%40gilbarbara/hooks/docs/useIsomorphicLayoutEffect.md) ——对客户端使用Layouteffect,对服务器使用effect.  
[使用更新效果](https://npmcn.com/package/%40gilbarbara/hooks/docs/useUpdateEffect.md) ——习惯使用效果不运行在挂载上.

### 生命周期

用于管理组件生命周期事件的钩子,例如起跑和卸载.

[使用月球](https://npmcn.com/package/%40gilbarbara/hooks/docs/useMount.md) ——在组件挂起时执行回调.  
[使用卸载](https://npmcn.com/package/%40gilbarbara/hooks/docs/useUnmount.md) ——当组件被卸载时执行回调.  
[使用生命周期Hooks](https://npmcn.com/package/%40gilbarbara/hooks/docs/useLifecycleHooks.md) ——当组件挂起并卸起时执行回调.  
[使用已模拟](https://npmcn.com/package/%40gilbarbara/hooks/docs/useIsMounted.md) ——检查组件是否仍然挂载.  
[使用首选项](https://npmcn.com/package/%40gilbarbara/hooks/docs/useIsFirstRender.md) - 检查它是否是第一个挂载.

### 参考文献和DOM

用于管理裁判和与DOM互动的钩子.

[使用最近数](https://npmcn.com/package/%40gilbarbara/hooks/docs/useLatest.md) 找到一个包含最新值的裁判.  
[使用元参考](https://npmcn.com/package/%40gilbarbara/hooks/docs/useMergeRefs.md) ——将多对数合并为一.  
[上一个](https://npmcn.com/package/%40gilbarbara/hooks/docs/usePrevious.md) ——跟踪变量的上一个值.

### 用户界面和相互作用

Hooks用于管理用户互动和响应性设计.

[使用断点](https://npmcn.com/package/%40gilbarbara/hooks/docs/useBreakpoint.md) ——获取适应性布局的响应断点.  
[使用 Click 外部](https://npmcn.com/package/%40gilbarbara/hooks/docs/useClickOutside.md) ——点击目标元素外时执行回调.  
[使用元素计量](https://npmcn.com/package/%40gilbarbara/hooks/docs/useElementMeasure.md) ——使用调整观察员API获取元素维度.  
[使用媒体查询](https://npmcn.com/package/%40gilbarbara/hooks/docs/useMediaQuery.md) ——检测媒体查询变化.  
[使用界面观察员](https://npmcn.com/package/%40gilbarbara/hooks/docs/useIntersectionObserver.md) - 探测到一个要素在取景口的能见度 [交叉观察员](https://developer.mozilla.org/en-US/docs/Web/API/Intersection_Observer_API) API (英语).  
[回复观察员](https://npmcn.com/package/%40gilbarbara/hooks/docs/useResizeObserver.md) - 使用 [调整观察员的大小](https://developer.mozilla.org/en-US/docs/Web/API/ResizeObserver) API (英语).  
[使用窗口大小](https://npmcn.com/package/%40gilbarbara/hooks/docs/useWindowSize.md) - 获取窗口尺寸。 调整大小的最新情况.

### 业绩和优化

通过减少不必要的执行频率或控制频率来优化性能的钩子.

[调试](https://npmcn.com/package/%40gilbarbara/hooks/docs/useDebounce.md) ——推迟运行执行,直到上次援引后延迟结束.  
[调用 数值](https://npmcn.com/package/%40gilbarbara/hooks/docs/useMemoizedValue.md) ——获得一个稳定值,只有在原始值真正不同时才会更新.  
[使用色调](https://npmcn.com/package/%40gilbarbara/hooks/docs/useThrottle.md) 返回每毫秒一次引用 fn 的节奏函数.  
[使用ThrottleValue 软件](https://npmcn.com/package/%40gilbarbara/hooks/docs/useThrottleValue.md) ——返回每毫秒只变化一次的受压值.

### 计时器

Hooks用于管理基于时间的操作.

[使用Interval系统](https://npmcn.com/package/%40gilbarbara/hooks/docs/useInterval.md) ——以指定的延迟反复执行回调.  
[使用超时](https://npmcn.com/package/%40gilbarbara/hooks/docs/useTimeout.md) ——在指定延迟后执行回调.

### 数据获取

Hooks)用于与API和第三方脚本合作.

[使用图像](https://npmcn.com/package/%40gilbarbara/hooks/docs/useFetch.md) - 请求取回。 它支持动态的URL,缓存,再试等更多功能.  
[使用脚本](https://npmcn.com/package/%40gilbarbara/hooks/docs/useScript.md) ——动态地加载脚本标记并附入文档.body.

### 调试与发展

钩子用于调试,监测和优化组件行为.

[使用数据变化](https://npmcn.com/package/%40gilbarbara/hooks/docs/useDataChanges.md) 检测哪个道/状态变化导致一个组件重新投放.  
[使用“调制解码”](https://npmcn.com/package/%40gilbarbara/hooks/docs/useRenderCount.md) 记录组件已提供多少次.  
[使用更新](https://npmcn.com/package/%40gilbarbara/hooks/docs/useUpdate.md) ——返回调用时重置组件的函数.

### 公用事业

[使用本地服务器](https://npmcn.com/package/%40gilbarbara/hooks/docs/useLocalStorage.md) ——与浏览器本地Storage API互动.  
[用户地址](https://npmcn.com/package/%40gilbarbara/hooks/docs/useLocation.md) ——跟踪浏览器位置.  
[用户](https://npmcn.com/package/%40gilbarbara/hooks/docs/useOnce.md) ——在组件产生前一次执行代码.

## ESLint 配置

为了充分利用有依赖关系的钩子,在你的ESLint配置中加入以下规则: 使用自定义的钩子

```json
{
  "rules": {
    "react-hooks/exhaustive-deps": [
      "warn", {
        "additionalHooks": "(useDebounce|useUpdateEffect|use.*DeepCompare)"
      }
    ]
  }
}
```

## 许可证

麻省理工学院

## 常见问题

### @gilbarbara/hooks 是什么？

收集有用的反应钩

### 如何安装 @gilbarbara/hooks？

在项目目录运行 npm install @gilbarbara/hooks，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（16\.8 - 19）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @gilbarbara/hooks 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @gilbarbara/hooks 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @gilbarbara/hooks 可以商用吗？

@gilbarbara/hooks 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @gilbarbara/hooks 的下载量有多少？

根据 npm 官方下载统计，@gilbarbara/hooks 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,484,888 次，日均约 149,496 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @gilbarbara/hooks 还在维护吗？

最新版本 0\.11\.0 发布于 2026/02/07（9 个月前）；至今共发布 27 个版本，其中过去 12 个月发布了 2 个；首次发布于 2020/03/06。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

