如何从大型C++/C#代码库中提取公共接口并检测变更？

这个需求已经有非常成熟的落地方案，下面分场景给你可直接复用的实现路径：

你之前遇到的输出包含private字段的问题，只需要修改Doxygen配置文件的几个核心开关就能解决：

• 把EXTRACT_PRIVATE设置为NO，这是控制是否导出私有成员的核心开关
• 把EXTRACT_PACKAGE设置为NO，过滤包级私有/内部可见的内容
• 把EXTRACT_PROTECTED按你的需求设置，如果需要导出子类可见的protected接口就设为YES，不需要就设为NO
• 关闭不需要的输出格式，仅保留GENERATE_XML = YES减少生成耗时

生成XML结果后，写几十行的简单脚本遍历XML节点，仅提取标记为public的类、方法、属性、字段签名，按命名空间、类的层级格式化输出为纯文本即可，完全不用保留实现逻辑。

如果不需要生成文档，仅要接口清单，用语言专属工具会比Doxygen更轻量、结果更准确：

C# 专用实现 #

直接用微软官方的dotnet api dump工具，不需要解析源码，仅用编译后的dll即可生成规整的公开接口清单：

• 安装命令：dotnet tool install -g Microsoft.DotNet.ApiCompat.Tool
• 生成接口清单命令：dotnet api dump --assembly 你的程序集路径 --output api_list.txt
• 输出结果自动过滤所有非公开成员，仅保留public接口的完整签名，格式标准化可以直接用于diff对比。

C++ 专用实现 #

用Clang生态的castxml工具解析源码生成AST的XML表述，筛选访问修饰符为public的节点即可：

• castxml基于Clang前端实现，语法解析准确率远高于正则匹配类的工具，不会受代码注释、宏定义的干扰
• 也可以搭配doxyrest工具直接将Doxygen的XML输出转换为格式化的纯文本接口清单，省去自己写解析脚本的工作量。

你需要的变更提醒能力可以直接集成到CI流水线实现：

• 将接口提取脚本配置为CI的固定步骤，每次主分支代码变更时自动执行，生成当前版本的api_current.txt
• 提前存储上一个版本的基准接口文件api_baseline.txt，每次构建时自动对两个文件做diff
• 如果diff结果非空就触发告警：可以直接在CI合入页面输出变更内容，也可以推送到内部沟通群，还可以配置为合入门禁，未经过审批的接口变更禁止合入
• 接口变更经过确认后，将新生成的api_current.txt覆盖为新的基准文件即可。

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