在C++中使用pugixml搜索、遍历、替换XML多标签的最优方法

方案一：使用pugixml内置XPath查询（最优） #

pugixml原生支持XPath 1.0标准，不需要自己实现深度遍历逻辑，直接通过XPath语法即可实现全文档的节点搜索，完全满足通用替换需求。
你给出的模板里的占位符分两种：嵌套在独立标签内的（比如<es:CantReg>%(num_records)</es:CantReg>）、直接作为父节点文本内容的（比如<es:Tag1>下直接写的%(auth)），可以用一套通用逻辑统一处理：

示例代码 #

#include <pugixml.hpp>
#include <string>
#include <unordered_map>

// 通用替换函数，传入xml文档对象和占位符-值映射表即可完成全文档替换
void replace_all_placeholders(pugi::xml_document& doc, const std::unordered_map<std::string, std::string>& value_map)
{
    // 1. 遍历所有文本节点，替换占位符（覆盖标签内、父节点直接文本两种场景）
    pugi::xpath_node_set text_nodes = doc.select_nodes("//text()");
    for (auto& xpath_node : text_nodes)
    {
        pugi::xml_node text_node = xpath_node.node();
        std::string content = text_node.value();
        
        // 遍历所有占位符替换
        for (auto& item : value_map)
        {
            const std::string& placeholder = item.first;
            const std::string& value = item.second;
            std::string full_placeholder = "%(" + placeholder + ")";
            size_t pos = 0;
            while ((pos = content.find(full_placeholder, pos)) != std::string::npos)
            {
                content.replace(pos, full_placeholder.length(), value);
                pos += value.length();
            }
        }
        
        // 更新文本内容
        text_node.set_value(content.c_str());
    }
}

// 调用示例
int main()
{
    pugi::xml_document doc;
    if (!doc.load_file("your_template.xml")) return -1;
    
    // 构造值映射表，直接把结构体里的字段转成这个表即可
    std::unordered_map<std::string, std::string> values = {
        {"auth", "你的鉴权信息"},
        {"num_records", "10"},
        {"pto_data", "xxx"},
        {"data_type", "json"},
        {"user_data", "测试用户数据"},
        {"CA", "CA值"},
        {"datetime_date", "2024-01-01"}
    };
    
    replace_all_placeholders(doc, values);
    
    // 保存结果或者输出
    doc.save(std::cout);
    return 0;
}

说明 #

• //text()是XPath语法，代表匹配全文档所有层级的文本节点，不需要关心节点嵌套结构
• 如果你确实需要按标签名查找节点直接替换内容，也可以用doc.select_nodes("//es:CantReg")直接获取所有对应标签的节点，再修改其text值即可

方案二：手动实现深度递归遍历（无XPath依赖） #

如果你环境中的pugixml裁剪了XPath模块，可以自己写递归函数遍历全文档所有节点，逻辑非常简单：

示例代码 #

#include <pugixml.hpp>
#include <string>
#include <unordered_map>

void traverse_node(pugi::xml_node node, const std::unordered_map<std::string, std::string>& value_map)
{
    // 处理当前节点的文本内容
    if (node.type() == pugi::node_pcdata)
    {
        std::string content = node.value();
        for (auto& item : value_map)
        {
            const std::string& placeholder = item.first;
            const std::string& value = item.second;
            std::string full_placeholder = "%(" + placeholder + ")";
            size_t pos = 0;
            while ((pos = content.find(full_placeholder, pos)) != std::string::npos)
            {
                content.replace(pos, full_placeholder.length(), value);
                pos += value.length();
            }
        }
        node.set_value(content.c_str());
        return;
    }
    
    // 递归遍历所有子节点
    for (pugi::xml_node child = node.first_child(); child; child = child.next_sibling())
    {
        traverse_node(child, value_map);
    }
}

// 调用方式和方案一完全一致
void replace_all_placeholders(pugi::xml_document& doc, const std::unordered_map<std::string, std::string>& value_map)
{
    traverse_node(doc, value_map);
}

注意事项 #

如果你的占位符需要替换为XML片段而非纯文本，不要直接修改文本节点的值，否则XML的尖括号会被转义。这种情况下可以：

1. 先删除原有占位符所在的文本节点
2. 用pugi::xml_node::append_buffer方法把XML片段解析为节点插入到对应位置即可

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