Alpine Docker镜像中GitLab CI/CD运行Doxygen Windows二进制文件失败

问题根源 #

你用的是Alpine（Linux）镜像，却下载了Windows版本的Doxygen二进制文件。Linux系统无法直接运行.exe格式的Windows可执行程序，所以即便ls命令能显示文件存在，执行时仍会触发"文件未找到"的错误（退出码127本质是命令无法被系统执行）。

解决方案 #

方案1：安装Linux版Doxygen 1.9.8

在Alpine镜像中安装对应Linux版本的Doxygen，有两种方式：

• 源码编译安装（适合需要精准控制版本的场景）：

  # 安装编译依赖
  apk add --no-cache gcc g++ cmake make git
  # 克隆Doxygen 1.9.8源码仓库
  git clone --branch Release_1_9_8 https://gitlab.com/doxygen/doxygen.git
  cd doxygen
  mkdir build && cd build
  # 编译并安装
  cmake ..
  make -j$(nproc)
  make install
  # 验证版本
  doxygen -v
  

• 使用预编译二进制包：
  下载Doxygen官方提供的Linux预编译包（注意匹配镜像架构，如x86_64），解压后直接调用：

  # 下载Linux版Doxygen 1.9.8压缩包
  wget https://doxygen.nl/files/doxygen-1.9.8.linux.bin.tar.gz
  # 解压
  tar -xzf doxygen-1.9.8.linux.bin.tar.gz
  # 验证版本
  ./doxygen-1.9.8/bin/doxygen -v
  

方案2：切换到Windows运行镜像

如果必须依赖Windows版Doxygen，需将CI/CD的运行环境切换为Windows容器（比如mcr.microsoft.com/windows/servercore:ltsc2022），之后再执行Windows版本的命令：

.\doxygen.exe -v

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