一个用于数据请求的 React Hooks 库，先返回缓存数据，再在后台自动重新验证。
3.2万1401TypeScriptMIT更新于 4天前
TanStack/query
面向 Web 应用的异步状态管理与数据获取库，支持 React、Vue、Svelte 和 Solid。
- Star
- 50,456
- Fork
- 4,222
- 未关闭 Issue
- 151
- 最近提交
- 2小时前
这是什么？
TanStack Query 是一个异步状态管理库，用于在 Web 应用中获取、缓存、同步和更新服务端状态。它与协议无关，可以配合 REST、GraphQL 或任何基于 Promise 的数据源使用。
库内提供缓存、后台重新请求、分页与无限滚动、变更（mutation）、依赖查询、预取和请求取消等常见数据获取功能，并支持 React Suspense。核心逻辑位于与框架无关的包中，同时提供 React、Vue、Svelte 和 Solid 的官方适配层。
项目使用 TypeScript 编写，是 TanStack 生态的一部分，同系列还包括 Router、Table、Form 和 Virtual 等库。
核心功能
- 01带缓存，并支持后台重新请求
- 02支持分页、无限滚动和依赖查询
- 03支持变更操作并更新缓存
- 04支持预取和请求取消
- 05提供 React、Vue、Svelte 和 Solid 的官方绑定
适用场景
- 在 React 或 Vue 前端中从 REST 或 GraphQL 接口加载数据
- 替代客户端中手写的加载、错误处理和缓存逻辑
- 为远程数据实现无限滚动列表或分页表格
快速上手
- 1
阅读文档并选择框架绑定
- 2
按照 CONTRIBUTING.md 中的说明进行设置
标签
常见问题
- query 是什么？
- 面向 Web 应用的异步状态管理与数据获取库，支持 React、Vue、Svelte 和 Solid。 TanStack Query 是一个异步状态管理库，用于在 Web 应用中获取、缓存、同步和更新服务端状态。它与协议无关，可以配合 REST、GraphQL 或任何基于 Promise 的数据源使用。
- query 可以免费使用吗？用的什么许可证？
- query 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
- query 还在维护吗？
- 活跃维护中。query 最近一次提交是在 2026年10月21日。
- query 适合用来做什么？
- 在 React 或 Vue 前端中从 REST 或 GraphQL 接口加载数据 替代客户端中手写的加载、错误处理和缓存逻辑 为远程数据实现无限滚动列表或分页表格
- query 怎么安装和运行？
- 阅读文档并选择框架绑定 按照 CONTRIBUTING.md 中的说明进行设置
- 在哪里获取 query？
- 源代码和安装说明在 GitHub 上：https://github.com/TanStack/query
概要由 AI 根据项目 README 生成；GitHub 数据每日更新。
相关项目
无头（headless）表格库，支持排序、过滤、分组和分页，可完全自定义 UI，适配 React、Vue、Solid、Svelte 等框架。
2.9万3589TypeScriptMIT更新于 8天前
一个基于 Hook 的轻量 React 状态管理库，无需包裹 Provider。
5.9万2176TypeScriptMIT更新于 7天前
基于 ProseMirror 的无界面富文本编辑器框架，可与多种前端框架配合，通过扩展灵活定制。
3.9万3171TypeScriptMIT更新于 9小时前
用于构建节点式交互界面（如流程图、图编辑器和工作流编辑器）的 React 与 Svelte 开源库。
3.9万2559TypeScriptMIT更新于 15小时前
一套代码多端运行的跨端跨框架方案，可用 React/Vue 开发微信等小程序、H5 和 React Native 应用。
3.8万4867TypeScriptOther更新于 22小时前