寻求可定位C++代码每行语句依赖头文件的工具

我来帮你梳理下这个需求的解决方案——按行追踪C++代码依赖的头文件，进而做合规性统计，确实是个挺实用的场景，尤其是在严格的代码规范要求下。

这些工具能帮你快速实现按行/语句的头文件依赖分析：

• Clang/LLVM 生态工具：Clang本身就具备精准的AST（抽象语法树）分析能力，能追踪每个符号的定义来源。你可以用clang-check配合AST导出功能，或者直接基于Clang写轻量插件——它能直接关联每个语句的行号和对应符号的头文件。另外，clangd（Clang的语言服务器）也能通过LSP接口获取符号的定义位置，进而映射到头文件。
• CppDepend：这款商业工具支持高度自定义的代码依赖查询，虽然默认是按文件维度，但用它的CQL（代码查询语言）可以写出遍历语句、关联符号头文件的查询，直接输出你要的行级结果。
• CodeQL：GitHub的CodeQL针对C++有成熟的分析库，你可以编写自定义查询，遍历代码中的每一条语句，提取其中的符号并追踪到定义它们的头文件，最后关联行号生成结构化输出。

如果现成工具没法完全匹配你的需求，自己基于Clang写个小插件是最灵活的方案，核心逻辑大概是这样：

1. 遍历AST节点：用Clang的RecursiveASTVisitor遍历代码中的每一条语句（Stmt节点），获取语句对应的行号。
2. 提取符号并追踪来源：对语句中的每个符号（比如std::cout），通过AST节点找到它的声明（Decl），再获取声明所在的头文件路径。
3. 输出结构化结果：把行号、符号、头文件关联起来，输出成你需要的格式。

给你一段简化的伪代码参考：

class LineHeaderVisitor : public RecursiveASTVisitor<LineHeaderVisitor> {
private:
  SourceManager* srcMgr;

public:
  explicit LineHeaderVisitor(SourceManager* sm) : srcMgr(sm) {}

  bool VisitStmt(Stmt* stmt) {
    SourceLocation loc = stmt->getBeginLoc();
    if (!loc.isValid() || loc.isInSystemHeader()) return true;

    // 获取当前语句的行号
    unsigned lineNum = srcMgr->getSpellingLineNumber(loc);

    // 遍历语句中的所有表达式，提取符号
    for (auto* child : stmt->children()) {
      if (auto* declRef = dyn_cast<DeclRefExpr>(child)) {
        Decl* symbolDecl = declRef->getDecl();
        SourceLocation declLoc = symbolDecl->getLocation();
        // 获取符号定义所在的头文件名
        StringRef headerPath = srcMgr->getFilename(declLoc);
        // 输出目标格式
        llvm::outs() << "第" << lineNum << "行：" << symbolDecl->getNameAsString() 
                     << " 使用\"" << headerPath.str() << "\"\n";
      }
    }
    return true;
  }
};

拿到行级的头文件依赖数据后，统计合规性就很容易了：

1. 先明确允许的头文件列表，比如{"iostream", "vector", "string"}这类符合标准的头文件。
2. 遍历所有输出结果，统计三类数据：
   • 总有效代码行数（排除空行、注释行、预处理指令行）
   • 使用允许头文件的代码行数
   • 使用禁止头文件的代码行数
3. 计算合规指标：比如合规率 = (允许行数 / 总行数) * 100%，还可以进一步统计每个禁止头文件的使用占比，生成更细致的合规报告。

小提示 #

• 有些符号可能来自多个头文件（比如重载函数），可以根据需求选择全部列出，或者按编译优先级取第一个。
• 注意区分系统头文件和自定义头文件，避免把合规的系统头文件误判为违规。
• 预处理指令（比如#include）本身不需要统计，重点放在实际执行的代码语句上。

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