C++：libgraphqlparser（GraphQL 查询解析器）

概述

libgraphqlparser 是一个用 C++ 实现的 GraphQL 查询语言解析器，同时提供 C 和 C++ 两套 API。它可以将 GraphQL 查询文本解析为抽象语法树（AST），方便开发者构建各种 GraphQL 工具，例如代码生成器、静态分析器、校验器、编辑器插件等。

该库由 GraphQL 社区官方组织（graphql）维护，源代码托管在 GitHub 上，是 GraphQL 生态系统中重要的底层基础设施之一。

主要特性

• 双语言 API：同时提供 C 和 C++ 接口，便于不同语言背景的项目集成。
• 完整语法支持：可解析 GraphQL 查询、变更（Mutation）、订阅（Subscription）及片段（Fragment）等核心语法结构。
• AST 输出：解析结果以抽象语法树形式呈现，便于程序化遍历与处理。
• 轻量易嵌入：无复杂运行时依赖，适合嵌入到编译器、开发工具或服务器框架中。
• 官方背景：由 GraphQL 官方组织维护，具有较好的社区可靠性和长期维护潜力。

构建与集成

该项目支持通过 CMake 构建，基本流程如下：

git clone https://github.com/graphql/libgraphqlparser.git
cd libgraphqlparser
mkdir build && cd build
cmake ..
make
sudo make install

构建并安装完成后，在项目中可通过以下方式引用头文件：

#include <graphqlparser/GraphQLParser.h>

链接时需将 libgraphqlparser 库加入构建系统。具体的构建选项和依赖说明请参考项目仓库中的 README。

基本用法

以下为 C++ API 的典型使用示例（具体函数签名以项目头文件为准）：

#include <graphqlparser/GraphQLParser.h>
#include <iostream>
#include <memory>

int main() {
    // 待解析的 GraphQL 查询字符串
    const char* query = R"(
        query UserInfo($id: Int!) {
            user(id: $id) {
                name
                email
            }
        }
    )";

    graphql::ast::Node* root = nullptr;
    std::string error;

    // 解析查询
    if (!graphql::parseString(query, &root, &error)) {
        std::cerr << "解析失败: " << error << std::endl;
        return 1;
    }

    // root 为 AST 根节点，可在此进行遍历和处理
    // ...

    delete root;
    return 0;
}

对于 C API，可以包含相同的头文件，并使用对应的 C 风格函数完成解析。两者解析结果一致，可根据项目需求选择合适的接口。

应用场景

• GraphQL 服务端的请求解析与语法校验
• 客户端代码生成工具中的查询解析
• 构建 GraphQL 格式化工具、语法高亮器或静态分析器
• 在非 C/C++ 语言中通过 C 接口封装为其他语言的解析库

参考链接

• 官方仓库：https://github.com/graphql/libgraphqlparser
• GraphQL 官方生态：https://graphql.org