直接用 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></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
示例：
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 <h3>XML 属性和文本内容怎么区分读取？</h3><p>PropertyTree 把 XML 属性存入子节点 <code><xmlattr></xmlattr></code>，把文本内容存在空键（<code>""</code>）下。这是最容易混淆的点。</p><p>比如这段 XML：</p><pre class="brush:php;toolbar:false;"><server port="8080">localhost</server>对应结构是：
-
pt.get<:string>("server.<xmlattr>.port")</xmlattr></:string>→"8080" -
pt.get<:string>("server")</:string>→"localhost"（注意不是"server.<xmltext>"</xmltext>） -
pt.get_optional<:string>("server.<xmltext>")</xmltext></:string>返回空——PropertyTree 不用<xmltext></xmltext>，只用空字符串键表示文本
如果节点既有属性又有子节点，文本内容仍走空键，子节点走各自名字：
<log level="debug"><file>app.log</file><rotate>true</rotate></log>
→ pt.get<:string>("log.<xmlattr>.level")</xmlattr></:string>，pt.get<:string>("log.file")</:string>，pt.get<:string>("log.rotate")</:string>，pt.get<:string>("log")</:string> 是未定义行为（该节点有子节点，空键无值）
遍历同名节点（如多个 <item></item>）要注意什么？
PropertyTree 不支持数组语义，多个同名节点会被合并成一个节点，其子节点按顺序排列。例如：
<list><item id="1">A</item><item id="2">B</item></list>
实际生成的结构是：list.item 是一个节点，它有两个子节点：<xmlattr>.id</xmlattr> 和文本内容，但两个 <item></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<:string>("<xmlattr>.id")</xmlattr></:string>，child.second.get_value<:string>()</:string>
XML 的嵌套深度、重复标签、混合内容（文本+子节点）会让 PropertyTree 的路径逻辑变得隐晦，动手前先用 write_xml() 输出一次看看实际结构，比硬猜靠谱得多。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
