@graphql-tools/webpack-loader

中文文档
8.1.0发布于 2026/10/26MITTypeScriptESM + CJS构建来源已验证近 30 天下载 82.6万

一套用于更快开发 GraphQL 工具的实用工具

中文使用文档
文档目录3 节
  1. 选项
  2. 导入图QL 文件
  3. 预处理查询和碎片

GraphQL 工具 Webpack 装入器

用于预处理 GraphQL 文档( 操作、 碎片和 SDL) 的 Webpack 加载器

略为不同的叉子 图克-tag/装入器。 。 。 .

npm install @graphql-tools/webpack-loader

如何是区别于 graphql-tag? 吗? 它完全删除位置,不包括来源 (导入文件的字符串内容),对重复的碎片名称没有警告,并支持更多 自定义方案.

选项

  • noDescription (单位:千美元)默认 : false——从SDL文档中取出描述. 没有影响 操作或碎片.
  • noEmptyNodes (单位:千美元)默认 : false- 条条为空 arguments, (中文(简体) ), directives,以及 variableDefinitions 从SDL文档。 对操作或碎片没有任何影响.
  • noLoc - 接受兼容性。 地点信息总是被删除.
  • replaceKinds (单位:千美元)默认 : false) - 替换 "kind": "Document" 释放 AST 中的字符串 与 Kind.DOCUMENT 参考文献 graphql/language/kinds。 。 。 .
  • esModule (单位:千美元)默认 : false- 发射 export default 改为 module.exports。 。 。 . #import 然后读取导入文档的默认导出.
  • importHelpers (单位:千美元)默认 : false) - (英语) require useUnique 从 @graphql-tools/webpack-loader-runtime 而不是内衬的助手.

导入图QL 文件

添加对导入的支持 .graphql编号 :.gql 文件,参见 网页包装入和预处理 见下文.

有档案 MyQuery.graphql

query MyQuery {
  ...
}

如果您已经配置 网络包@ graphql- tools/webpack-loader,您可以导入 包含图QL查询的模块。 导入值将是预建的 AST .

import MyQuery, { MyQuery as NamedMyQuery } from './query.graphql'

文件可能包含多个操作. 默认导出是整个文档 。 每个名字 操作和碎片也用其GraphQL名称被导出,只有碎片 操作用途 :

# menuMutations.graphql
mutation deleteMenuMutation {
  deleteMenu {
    ...MenuFields
  }
}

mutation upsertMenuMutation {
  upsertMenu {
    id
  }
}

fragment MenuFields on Menu {
  id
  name
}
import { deleteMenuMutation, MenuFields, upsertMenuMutation } from './menuMutations.graphql'

带入的碎片 #import 也以导入的图形QL 名称导出 文档,在后面附上所导入的定义.

@graphql-tools/jest-transform 使用这个装载机,所以同名的进口在杰斯工作. 业务 在多操作文件中必须命名.

预处理查询和碎片

预处理GraphQL查询和在构建时将片段打入AST可以大大地改善负载时间.

网页包装入和预处理

使用包含的内容 @graphql-tools/webpack-loader 可以维持查询逻辑,即 与其它应用程序逻辑分离。 在装入器配置下, 导入了图QL 文件 将在 Webpack 构建过程中转换为 AST .

{
  loaders: [
    {
      test: /\.(graphql|gql)$/,
      exclude: /node_modules/,
      loader: '@graphql-tools/webpack-loader',
      options: {
        /* ... */
      }
    }
  ],
}

版本与发布记录

@graphql-tools/webpack-loader 共发布 664 个版本,首次发布于 2020/06/02;过去 12 个月发布了 153 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
8.1.0latest2026/10/2621 天前
8.1.0-rc-20261026131423-8fabaf53c1774b23fb7f57b7dadfe5d6b5213dacrc2026/10/2621 天前
8.1.0-alpha-20261026123108-071eb6cfddd27d23db13b9ffc9051c072334a401alpha2026/10/2621 天前
8.1.0-alpha-20261026122756-d820b8099b0a6fe9c218e6e0820ecc34b7e5daf52026/10/2621 天前
8.1.0-alpha-20261026121847-75fd8ee1b5baa57c5039f3d1805399a1e4f2d5102026/10/2621 天前
8.1.0-alpha-20261026031207-872f174b78389989102096bcfff633be6688b5502026/10/2621 天前

其他发布通道:canary → 6.2.4-alpha-dee550e0.0,beta → 6.5.0-alpha-e6320b00.0,alpha → 8.1.0-alpha-20261026123108-071eb6cfddd27d23db13b9ffc9051c072334a401,rc → 8.1.0-rc-20261026131423-8fabaf53c1774b23fb7f57b7dadfe5d6b5213dac。

关于 @graphql-tools/webpack-loader 的常见问题

@graphql-tools/webpack-loader 是什么?

一套用于更快开发 GraphQL 工具的实用工具

如何安装 @graphql-tools/webpack-loader?

在项目目录运行 npm install @graphql-tools/webpack-loader,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:graphql(^16.0.0 || ^17.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@graphql-tools/webpack-loader 支持 TypeScript 吗?

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

@graphql-tools/webpack-loader 支持 ESM 还是 CommonJS?

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

@graphql-tools/webpack-loader 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.18.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@graphql-tools/webpack-loader 可以商用吗?

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

@graphql-tools/webpack-loader 的下载量有多少?

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

@graphql-tools/webpack-loader 还在维护吗?

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