@bicou/nuxt-urql

中文文档
1.11.4发布于 2026/03/30MITTypeScriptES Module构建来源已验证近 30 天下载 4403

Nuxt URQL module

原始使用文档
文档目录3 节
  1. Features
  2. Quick Setup
  3. Development

Nuxt URQL module

npm version npm downloads License Nuxt

URQL client for Nuxt v3 and v4

Features

  • @urql/vue integration
  • SSR exchange
  • client customization

Quick Setup

Add @bicou/nuxt-urql dependency to your project

# Using pnpm
pnpm add -D @bicou/nuxt-urql graphql

# Using yarn
yarn add --dev @bicou/nuxt-urql graphql

# Using npm
npm install --save-dev @bicou/nuxt-urql graphql

Add @bicou/nuxt-urql to the modules section of nuxt.config.ts and configure the urql client with the endpoint url

export default defineNuxtConfig({
  modules: [
    '@bicou/nuxt-urql'
  ],
  urql: {
    endpoint: "http://myapi/graphql"
  }
})

That's it! You can now use Nuxt URQL module in your Nuxt app ✨

<template>
  <div>{{ data }}</div>
</template>

<script setup lang="ts">
const { data } = await useQuery({
  query: gql`
    query name {
      # ...
    }
  `,
});
</script>

Development

# Install dependencies
npm install

# Generate type stubs
npm run dev:prepare

# Develop with the playground
npm run dev

# Build the playground
npm run dev:build

# Run ESLint
npm run lint

# Run Vitest
npm run test
npm run test:watch

版本与发布记录

@bicou/nuxt-urql 共发布 35 个版本,首次发布于 2023/02/02;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.11.4latest2026/03/307 个月前
1.11.32025/11/2811 个月前
1.11.22025/08/281.2 年前
1.11.12025/04/081.6 年前
1.11.02025/04/021.6 年前
1.10.02025/03/231.6 年前

关于 @bicou/nuxt-urql 的常见问题

@bicou/nuxt-urql 是什么?

Nuxt URQL module

如何安装 @bicou/nuxt-urql?

在项目目录运行 npm install @bicou/nuxt-urql,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:defu(^6.1.4)、graphql(^16.10.0)、vue(^3.5.20)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@bicou/nuxt-urql 支持 TypeScript 吗?

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

@bicou/nuxt-urql 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@bicou/nuxt-urql 可以商用吗?

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

@bicou/nuxt-urql 的下载量有多少?

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

@bicou/nuxt-urql 还在维护吗?

最新版本 1.11.4 发布于 2026/03/30(7 个月前);至今共发布 35 个版本,其中过去 12 个月发布了 2 个;首次发布于 2023/02/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。