框架
版本

安装

安装

您可以通过 NPM 安装 React Query,或者通过 ESM.sh 使用传统的 <script> 标签引入。

NPM

bash
npm i @tanstack/react-query
npm i @tanstack/react-query

bash
pnpm add @tanstack/react-query
pnpm add @tanstack/react-query

bash
yarn add @tanstack/react-query
yarn add @tanstack/react-query

bash
bun add @tanstack/react-query
bun add @tanstack/react-query

React Query 兼容 React v18+ 版本,支持 ReactDOM 和 React Native。

想在下载前试用一下?试试 简单示例基础示例

CDN

如果您不使用模块打包工具或包管理器,也可以通过 ESM 兼容的 CDN 如 ESM.sh 来使用该库。只需在 HTML 文件底部添加一个 <script type="module"> 标签:

html
<script type="module">
  import React from 'https://esm.sh/[email protected]'
  import ReactDOM from 'https://esm.sh/[email protected]'
  import { QueryClient } from 'https://esm.sh/@tanstack/react-query'
</script>
<script type="module">
  import React from 'https://esm.sh/[email protected]'
  import ReactDOM from 'https://esm.sh/[email protected]'
  import { QueryClient } from 'https://esm.sh/@tanstack/react-query'
</script>

您可以在 这里 找到不使用 JSX 来使用 React 的说明。

环境要求

React Query 针对现代浏览器进行了优化,兼容以下浏览器配置:

Chrome >= 91
Firefox >= 90
Edge >= 91
Safari >= 15
iOS >= 15
Opera >= 77
Chrome >= 91
Firefox >= 90
Edge >= 91
Safari >= 15
iOS >= 15
Opera >= 77

根据您的环境,可能需要添加 polyfill。如果需要支持旧版浏览器,您需要自行转译 node_modules 中的库文件。

推荐配置

建议同时使用我们的 ESLint Plugin Query 来帮助您在编码时发现错误和不一致。可通过以下命令安装:

bash
npm i -D @tanstack/eslint-plugin-query
npm i -D @tanstack/eslint-plugin-query

bash
pnpm add -D @tanstack/eslint-plugin-query
pnpm add -D @tanstack/eslint-plugin-query

bash
yarn add -D @tanstack/eslint-plugin-query
yarn add -D @tanstack/eslint-plugin-query

bash
bun add -D @tanstack/eslint-plugin-query
bun add -D @tanstack/eslint-plugin-query