XPath查不到节点主因是命名空间未处理，需显式声明或用local-name()；text()返回字符串列表，.text仅取首文本且易为None；提取可选字段应使用next(iter(xpath()), default)避免索引错误。
能用 lxml 解析 XML 配置文件，但直接套 XPath 不一定拿到想要的值——常见问题不是语法写错，而是命名空间、文本提取方式、节点存在性这三处卡住。
为什么 XPath 查不到节点？多半是命名空间在捣鬼
很多配置 XML（如 Spring、Maven 的 pom.xml）带默认命名空间，例如 <config xmlns="http://example.com/ns"></config>。此时 //service 会完全匹配失败，因为 XPath 默认不识别该命名空间。
- 检查根节点是否有
xmlns或xmlns:xsi属性，用root.nsmap看解析后映射 - 显式声明命名空间字典，比如
ns = {'ns': 'http://example.com/ns'} - 查询时带上前缀：
tree.xpath('//ns:service', namespaces=ns) - 若懒得处理命名空间，可用通配符：
//*[(local-name()='service')]（性能略低，但应急有效）
text() 和 .text 到底该用哪个？
XPath 表达式末尾加 /text() 返回字符串节点，而 Python 中调用 .text 属性只取子节点**第一个文本内容**——二者行为不同，且都可能返回 None。
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
-
tree.xpath('//host/text()')→ 返回字符串列表，空节点得 [] -
tree.xpath('//host')[0].text→ 若<host>127.0.0.1</host>成功，但<host><ip>127.0.0.1</ip></host>就返回None - 稳妥做法：先判断节点是否存在，再用
.xpath('string(.)')提取合并后的全部文本（含子节点内文）
如何安全提取可选配置项（比如没写的端口号）？
XML 配置里常有可选字段，硬写 [0] 索引会触发 IndexError；用 find() 又不支持复杂 XPath。
立即学习“Python免费学习笔记（深入）”；
- 始终用
tree.xpath()返回列表，再用next(iter(...), default)安全取首项 - 示例：
port_node = next(iter(tree.xpath('//server/port/text()')), '8080') - 避免用
find('.//port')—— 它不支持轴（如following-sibling）和函数，表达能力弱 - 如果要校验必填字段缺失，建议提前收集所有报错路径，而不是靠 try/except 捕获
IndexError
真正麻烦的不是写 XPath，而是配置文件里混着注释节点、空白文本、默认命名空间和 CDATA 块——这些都会让 .text 或 /text() 返回意外结果。动手前先用 etree.tostring(node, encoding='unicode', pretty_print=True) 看一眼实际解析结构，比猜快得多。
