Docker容器编译libgpiod 2.x.x遇HAS_GI_DOCGEN未定义错误求助

conditional "HAS_GI_DOCGEN" was never defined这个报错的核心原因是：libgpiod 2.x.x的构建脚本依赖gi-docgen工具生成文档，但在配置阶段，对应的条件判断宏未被正确加载或检测到。要么是缺少gi-docgen这个关键依赖，要么是autoconf-archive安装后，脚本需要的特定宏没有被正确引入，导致配置逻辑报错。

方案一：安装完整构建依赖 #

在Debian Bookworm Slim的Dockerfile里，补充安装gi-docgen以及其他必备的构建工具，确保配置脚本能正常检测到文档生成工具：

RUN apt-get update && apt-get install -y --no-install-recommends \
    autoconf \
    autoconf-archive \
    automake \
    libtool \
    pkg-config \
    gcc \
    g++ \
    git \
    gi-docgen \
    libglib2.0-dev \
    && rm -rf /var/lib/apt/lists/*

方案二：跳过文档生成（无需文档时用） #

如果你的场景不需要libgpiod的文档，可以直接在配置阶段禁用文档生成模块，彻底绕开这个依赖问题：

# 克隆并编译libgpiod
RUN git clone --branch v2.x.x https://git.kernel.org/pub/scm/libs/libgpiod/libgpiod.git /tmp/libgpiod \
    && cd /tmp/libgpiod \
    && ./autogen.sh \
    && ./configure --prefix=/usr --disable-gi-docgen \
    && make -j$(nproc) \
    && make install \
    && rm -rf /tmp/libgpiod

验证修改 #

把Dockerfile更新后重新执行docker build，就能顺利完成libgpiod 2.x.x的编译安装，不会再出现该条件未定义的错误。

内容的提问来源于stack exchange，提问作者Mendes