直接用 read_xml() 报错或读空的根本原因是XML文件编码非UTF-8（如GBK/UTF-16）或根节点不匹配，Boost.PropertyTree仅支持UTF-8无BOM格式，且要求有唯一顶层包装标签。
为什么直接用 read_xml() 会报错或读空？
常见现象是调用 read_xml() 后 ptree 为空，或抛出 boost::property_tree::xml_parser::xml_parser_error。根本原因通常是 XML 文件编码不是 UTF-8（比如 Windows 记事本默认保存为 GBK/UTF-16），或者根节点名与默认期望不匹配。
Boost.PropertyTree 的 XML 解析器只原生支持 UTF-8 编码，且默认把顶层元素当作根（即 <root><child>val</child></root> 中的 <root> 是隐式根）。若文件含 BOM 或声明了 <?xml version="1.0" encoding="GBK"?>，解析就会失败。
- 确保 XML 文件以 UTF-8 无 BOM 格式保存（VS Code、Notepad++ 均可设置）
- 避免在 XML 声明中指定非 UTF-8 编码；如有，要么删掉声明，要么用宽字符流预处理
- 若 XML 没有顶层包装标签（如纯
<item>...</item><item>...</item>），read_xml()会拒绝解析——必须包一层，比如<config>...</config>
read_xml() 的三个关键参数怎么选？
函数签名是 read_xml(const std::string&, ptree&, int)，第三个参数是 flag，控制解析行为。默认值 0 很容易踩坑：
-
boost::property_tree::xml_parser::no_comments：跳过注释节点（否则注释会被当成键为<xmlattr>.comment</xmlattr>的条目） -
boost::property_tree::xml_parser::trim_whitespace：自动 trim 文本节点首尾空白（否则换行缩进会变成值的一部分） - 常用组合：
boost::property_tree::xml_parser::no_comments | boost::property_tree::xml_parser::trim_whitespace
示例：
立即学习“C++免费学习笔记（深入）”；
ptree pt;
try {
read_xml("config.xml", pt,
boost::property_tree::xml_parser::no_comments |
boost::property_tree::xml_parser::trim_whitespace);
} catch (const boost::property_tree::xml_parser::xml_parser_error& e) {
std::cerr << "XML parse error at " << e.filename()
<< ":" << e.line() << ": " << e.message() << "\n";
}XML 属性和文本内容怎么区分读取？
PropertyTree 把 XML 属性存入子节点 <xmlattr>，把文本内容存在空键（""）下。这是最容易混淆的点。
比如这段 XML：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
<server port="8080">localhost</server>
对应结构是：
-
pt.get<std::string>("server.<xmlattr>.port")→"8080" -
pt.get<std::string>("server")→"localhost"（注意不是"server.<xmltext>"） -
pt.get_optional<std::string>("server.<xmltext>")返回空——PropertyTree 不用<xmltext>，只用空字符串键表示文本
如果节点既有属性又有子节点，文本内容仍走空键，子节点走各自名字：
<log level="debug"><file>app.log</file><rotate>true</rotate></log>
→ pt.get<std::string>("log.<xmlattr>.level")，pt.get<std::string>("log.file")，pt.get<std::string>("log.rotate")，pt.get<std::string>("log") 是未定义行为（该节点有子节点，空键无值）
遍历同名节点（如多个 <item>）要注意什么？
PropertyTree 不支持数组语义，多个同名节点会被合并成一个节点，其子节点按顺序排列。例如：
<list> <item id="1">A</item> <item id="2">B</item> </list>
实际生成的结构是：list.item 是一个节点，它有两个子节点：<xmlattr>.id 和文本内容，但两个 <item> 被扁平化了——不对，其实是 list.item 会包含两个实例，需用迭代器遍历：
- 正确方式：
for (const auto& item : pt.get_child("list")) { ... }—— 这会遍历所有list的直接子节点 - 更安全写法：
for (const auto& item : pt.get_child("list.item")) { ... }不行，因为"list.item"只返回第一个 - 标准做法是：
for (const auto& child : pt.get_child("list")) { if (child.first == "item") { /* 处理 child.second */ } } - 或提前用
pt.get_child_optional("list")判空，再遍历
属性和文本要分开取：child.second.get<std::string>("<xmlattr>.id")，child.second.get_value<std::string>()
XML 的嵌套深度、重复标签、混合内容（文本+子节点）会让 PropertyTree 的路径逻辑变得隐晦，动手前先用 write_xml() 输出一次看看实际结构，比硬猜靠谱得多。
