安装 | TanStack Query React Docs

安装

您可以通过 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 一起使用。

想在下载前试用一下吗？试试 simple 或 basic 示例！

CDN

如果您不使用模块打包器或包管理器，也可以通过与 ESM 兼容的 CDN（例如 ESM.sh）��用此库。只需在 HTML 文件底部添加一个 <script type="module"> 标签即可：

html

<script type="module">
  import React from 'https://esm.sh/react@18.2.0'
  import ReactDOM from 'https://esm.sh/react-dom@18.2.0'
  import { QueryClient } from 'https://esm.sh/@tanstack/react-query'
</script>

<script type="module">
  import React from 'https://esm.sh/react@18.2.0'
  import ReactDOM from 'https://esm.sh/react-dom@18.2.0'
  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