Mercurial 没有官方 C++ API 或二进制库，核心运行于 Python 解释器中，不导出 C ABI、无头文件或静态/动态库；唯一可行路径是调用 hg 子进程解析 stdout 或嵌入 CPython 解释器（后者高风险且难维护）。
Mercurial 是用 Python 写的，它没有提供 C++ 可直接链接的“库文件”（如 libhg.a 或 hg.dll）。你无法像链接 libcurl 那样在 C++ 项目里 #include <hg.h> 然后调用 API —— 它压根不存在。
Mercurial 没有官方 C++ API 或二进制库
Mercurial 的核心逻辑完全运行在 Python 解释器中，所有命令（hg log、hg status）本质是调用 Python 模块（如 mercurial.cmdutil、mercurial.repo）。它不导出 C ABI，也不生成供 C/C++ 调用的头文件或静态/动态库。
- 你在系统上看到的
hg命令只是一个 Python 脚本（或 py2exe/pyinstaller 打包的可执行文件），不是 C 接口入口 - 源码里没有
hg_export.h、libhg.so这类产物；setup.py也不构建任何 C 扩展供外部链接 - 试图用
nm或objdump在hg可执行文件里找hg_repository_open这类符号？结果一定是空的
可行路径只有两种：进程调用或嵌入 Python
如果你的 C++ 程序需要获取 Mercurial 仓库信息（如当前分支、父节点哈希、未提交变更），只能通过间接方式桥接：
-
推荐：调用
hg子进程 + 解析 stdout —— 最稳定、无需绑定 Python 版本。例如：hg parent --template "{node|short}\n"输出 12 字符哈希，C++ 用popen()或std::process::Command（C++26）捕获输出即可 -
高风险：嵌入 CPython 解释器 —— 需手动初始化 Python，
PyImport_ImportModule("mercurial.ui")，再调用其函数。但 Mercurial 依赖具体 Python 版本、.pyc路径、环境变量（如HGRC）、甚至内部模块加载顺序；升级 Mercurial 或 Python 极易导致ImportError或段错误
注意 hg 命令的兼容性与性能陷阱
即使走子进程方案，也要避开常见坑：
立即学习“C++免费学习笔记（深入）”；
-
hg log -l1 --template "{node}"比hg parents --template "{node}"更慢，尤其在大型仓库；优先用parents、id、identify这类轻量命令 - 务必加
--repository /path/to/repo参数，否则hg会向上遍历目录找 .hg，可能误读到父目录的仓库 - 输出含 ANSI 转义序列？加
--config ui.color=never；需要机器可读？加--template并避免换行符污染（比如用"{node|urlescape}"） - Windows 上注意
hg.bat和hg.exe行为差异；建议用绝对路径调用，或检查where hg结果
真正难的不是“怎么读”，而是接受 Mercurial 本质上拒绝被 C++ 直接集成这个事实——所有绕过它的尝试，最终都会回到子进程或 Python 嵌入，而后者几乎没人在线上环境长期维护成功。
