小巧敏捷的 C/C++ 编译链接工具。用一份或多份 JSON 配置描述构建目标，把项目编成静态库、共享库或可执行程序；不生成 makefile，也不引入额外的构建语言。
当我刚开始用 c/c++ 做项目时，我花了很大的精力去掌握 cmake、make、gcc，又花了很大的精力终于理清他们之间的关系。终于后来，我可以熟练使用它们构建我的项目了。虽然有 meson 可以避免写 cmake、但是实际上并没有减轻我的配置负担。我是来开发程序的，然而我还要花大量精力去处理与代码本身无关的事情。每次一想起要写 c/c++ 项目，我都很难受。
为什么我要这么辛苦？为什么编译 c/c++ 项目不能通过写个 json 的方式简简单单地就实现呢？antelope 于是诞生了。大约在 2022 年，antelope 项目已经具备雏形。但是依然有很多功能没有实现，我还有很多别的事情处理，实在分不出时间来好好实现它。随着 agent 的能力越来越强大，我终于从繁重的 “古法编程” 中解脱了出来。在 agent 的帮助下，我的想法得到了快速实现。
你可以通过写一个 json 的方式，与 cmake 说拜拜了。你不用再关心复杂的编译后端，一切交给 antelope，除了完成编译链接任务外，还能从 10 个不同的角度给你生成可视化项目分析报告，让你更了解自己的项目产物。
作者：luskyle
- 配置即构建脚本：每份 JSON 配置描述一个构建目标；
antel init默认生成antel.json，也可用-f指定其他配置文件，分别构建库、工具或测试 - 并行编译：默认按 CPU 并行编译各编译单元（
jobs可调），并优先用 make 工具执行（backend: auto，没有 make 时自动回退内置执行器；仍由 antel 决定编什么）；同时输出compile_commands.json供 clangd 等工具使用 - 基于依赖的增量构建：每个编译单元都记录
-MMD依赖，改头文件只重编受影响的源文件，目标文件或依赖文件缺失时自动补编 - 诊断聚合：并行编译输出按单元捕获——成功只汇总警告数，失败按文件分组整块回放并计数，不被并发刷屏淹没
- 可视化分析报告：
report: true或antel analyze生成自包含的report.html，覆盖产物、增量状态、编译参数、符号表、头文件依赖、大小分布、动态依赖与日志清单，浏览器直接打开 - 第三方库零手抄：
pkg_config: ["libcurl"]自动注入pkg-config的--cflags/--libs，不手写-I/-l - Git 项目引用：
ref可在编译前浅克隆多个 Git 仓库到.antel/refs/，支持指定分支；下载的源文件按需列入source - 构建钩子：
before_build顺序执行生成脚本，声明outputs后变化会触发重编或重链；after_build在构建成功后顺序执行打包等脚本 - 运行资源一键打包：
data_files（复制进输出目录）、gresource（GLib 资源编进二进制）、embed（任意二进制经ld -r -b binary嵌入）三种形态，支持目录分发与单文件分发；资源变化自动触发重编/重链 - 版本化共享库：
version/soname/rpath产出libX.so.<版本>与软链，消费端按 SONAME 链接、$ORIGINrpath 加载 - 消毒器与覆盖率：
sanitize: ["address", "undefined"]与coverage: true一键注入，运行后gcov直接出覆盖率报告 - 失败即中断：编译、链接、分析、运行任一环节返回非 0 都立即终止，以非 0 退出码结束，不会把失败当成功
- 产物可追溯：实际执行的编译命令与链接脚本落盘到
log/，附带符号表、动态依赖等分析结果，便于事后核查
python3 antelope_install.pyantel init # 交互式生成 antel.json
antel rebuild # 全量构建
antel build # 只编发生变化的部分
antel run # 运行生成的可执行程序
antel analyze # 生成可视化分析报告 report.htmlantel init 默认创建 antel.json。除 init 外的命令都可用 -f <文件> 选择其他配置；项目可保留多份 JSON 配置，为不同目标复用同一套源码。
| 命令 | 作用 |
|---|---|
| init | 交互式生成 antel.json |
| fetch-ref | 只下载配置中声明的 Git 项目引用，不编译 |
| build | 构建项目差异部分 |
| sync-baseline | 只刷新 hash 基线，不编译（手工跑规则文件后对齐簿记） |
| rebuild | 重新构建项目。不管项目有否被构建过，都重新构建 |
| clean | 清除构建生成，包括所有中间文件与生成目标 |
| link | 只链接而不编译 |
| analyze | 生成可视化分析报告 report.html |
| run | 执行编译后的结果 |
除 init 外的命令都支持 --file / -f 指定配置文件，默认为 antel。
| compiler | 编译命令 | 静态库 | 共享库 / 可执行程序 |
|---|---|---|---|
| gxx | gcc/g++ | ✓ | g++ -shared / g++ -s |
| llvm | clang | ✓ | clang++（未验证） |
| msvc | cl | ✓ | 尚未实现，会直接报错 |
完整文档在 https://luskyle.github.io/antelope/：
| 页面 | 内容 |
|---|---|
| 快速开始 | 安装、init、最小配置、构建与运行 |
| 配置参考 | antel.json 全部字段（含 pkg_config / data_files / gresource / embed）与构建目录布局 |
| 示例与效果图 | GTK 计算器、资源打包演示的完整配置与运行效果 |
| 成功案例 | 多个公开项目的构建结果、目标说明与配置入口 |
| 报告示例 | 可视化报告完整效果（resdemo 实例嵌入）与十个区块逐项讲解 |
| 命令参考 | 各命令的参数、行为与退出码 |
| 增量构建 | 什么时候重编，hash 基线与依赖文件如何工作 |
| 编译器支持 | gxx / llvm / msvc 与目标类型的支持细节 |
| 开发与发布 | 测试、打包、发版流程与工作流 |
自带示例（demos/ 下）：helloworld、cdemo、gtkcalc、resdemo、antelstats，以及通过 ref 获取并由 Antel 编译的公开项目：libyaml、cjson、libpng、yaml-cpp、json-c、libuv、libgit2、lvgl。LVGL 案例还提供一个介绍 Antelope 构建流程、同时展示图表和交互控件的 SDL2 窗体应用。成功案例总览列出了各项目已验证的目标及对应配置。公开项目的构建配置不依赖 CMake 生成配置头或执行构建。
python3 -m pip install -e '.[test]'
python3 -m pytest若环境中安装了会干扰 pytest 启动的第三方插件（例如 ROS 2 提供的 launch_testing），改用 PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 python3 -m pytest。
文档站本地预览：
python3 -m pip install -r docs/requirements.txt
zensical serve项目 logo 使用 Microsoft Fluent Emoji 的山羊图标（MIT，经 Iconify 的 fluent-emoji-flat 集合取得）。文件都在 docs/images/ 下：logo.svg 与 logo-dark.svg 分别是浅色底与深色底版本，favicon.svg 是站点图标（内置 prefers-color-scheme 深色分支），许可原文见 LICENSE-fluent-emoji.txt。