在如今的 Web 开发中，GraphQL 已经成为一个流行的站点开发技术，并且在越来越多的场景下取代了 RESTful API。而当你开始使用 GraphQL 时，你可能会发现用它来写真正的应用程序是复杂、冗长和反复的。这时，GraphQL 工具包（GraphQL Tools）备受欢迎，因为它可以极大地简化应用程序的开发。
其中一个 GraphQL 工具就是 @graphql-tools/import 包，它为开发人员提供了一种方便的导入 GraphQL 文件的方法。
在本文中，我们将深入介绍 @graphql-tools/import，包括其安装和使用方法、指令的详细说明以及其他相关配置选项。最后，我们将提供一些示例代码，以帮助你更好地了解和使用这个强大的工具。
安装和使用
@graphql-tools/import 包可以使用 npm 安装，只需在终端中键入以下命令即可：
npm i @graphql-tools/import
安装完成后，你可以在项目代码中导入它：
const { importSchema } = require('@graphql-tools/import');指令说明
@graphql-tools/import 包包含两个指令：#import 和 #graphql。在 GraphQL 代码中，这两个指令可以在不同的位置使用并实现不同的功能。
#import 指令
#import 指令允许你将其他的 GraphQL 文件导入到当前的文件中。它非常适用于模块化 GraphQL 代码，并使其更易于组织和维护。
导入语法很简单：
#import "<path-to-file>"
其中 <path-to-file> 是要导入的文件的相对路径。例如，在您的项目中，如果有一个名为 types.graphql 的文件，您可以通过以下方式在其他 GraphQL 文件中导入它：
#import "./types.graphql"
如果您有多个导入语句，您可以将它们放在一起，以便使代码更加整洁：
#import "./types.graphql" #import "./resolvers.graphql"
#graphql 指令
#graphql 指令允许你使用字符串而不是 GraphQL 文件来定义你的架构。这对于从远程服务或其它源获取架构时非常有用。
以下是一些示例：
-- -------------------- ---- ------- ---- ----- - ------ ------- - ---- -------- - ------ ----- -- ------ ---- - -------- --- ---- ------ ------ --- ------ ---- -------- --- --- ---- ----- --- ---- --------- - -------- ----- ----- -
在这个例子中，你可以看到 #graphql 指令可以在其他类型和指令定义之间嵌入 GraphQL 字符串。
配置选项
@graphql-tools/import 包还提供了一些配置选项，以更好地适应您的项目需求。
下面是一些常用选项的说明：
ignore：一个数组，包含要忽略导入的文件的路径。cwd：一个字符串，表示导入路径的基础路径。processImport：一个可选的回调函数，用于对导入的文件内容进行处理。
例如，以下是如何设置 ignore 和 cwd：
-- -------------------- ---- -------
----- - ------------ - - ---------------------------------
----- ---- - ----------------
----- ------ - -------------
-------------------- --------------------
-
------- -
---------------------
------------------
--
---- -------------------- -------------
-
--示例代码
最后，以下是一些使用 @graphql-tools/import 包的示例代码。在这些示例中，我们将使用 @graphql-tools/import 来模块化您的代码和 GraphQL 文件，帮助您更好地组织和维护您的项目。
拆分类型
在这个例子中，我们将类型定义拆分到多个文件中。例如，我们可以在一个名为 types.graphql 的文件中定义我们的 Query 和 Mutation 类型：
type Query {
hello: String!
}
type Mutation {
add(x: Int!, y: Int!): Int!
}然后，在我们的主文件中，我们可以将文件导入到代码中：
#import "./types.graphql"
这会将 Query 和 Mutation 类型注入到我们的代码中，让我们可以更好地组织和维护我们的 GraphQL 逻辑。
拆分解析器
除了拆分类型，我们还可以拆分我们的解析器。例如，我们可以将 Query 和 Mutation 的每个解析器拆分到一个单独的文件中：
-- -------------------- ---- ------- -------- --- ----- --------- --- ---- ----- - ------ ------- - -------- --- -------- --------- --- ---- -------- - ------ ----- -- ------ ---- -
在一个名为 query-resolvers.graphql 的文件中实现 Query：
-- -------------------- ---- -------
----- - ------------ - - ---------------------------------
----- ---- - ----------------
----- ------ - -------------
-------------------- ----------------------------
--
----- --------- - -
------ -
------ -- -- --------
--
--
----- ------ - --- --------------
--------- -------
----------
---在一个名为 mutation-resolvers.graphql 的文件中实现 Mutation：
-- -------------------- ---- -------
----- - ------------ - - ---------------------------------
----- ---- - ----------------
----- ------ - -------------
-------------------- -------------------------------
--
----- --------- - -
--------- -
---- --- - -- - -- -- - - --
--
--
----- ------ - --- --------------
--------- -------
----------
---总结
@graphql-tools/import 包提供了一种非常方便的方法来导入和组织您的 GraphQL 代码。通过了解 @graphql-tools/import 的使用方法，您现在可以更好地组织和维护您的 GraphQL 代码。希望这篇文章对您有所帮助！
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/5eedc8a3b5cbfe1ea061230b