ProcessingInstruction（PI）节点是XML中形如的独立节点，nodeType为7，仅作为Document直接子节点存在，不嵌套在Element内，遍历时需从Document.getChildNodes()开始检查。
DOM中ProcessingInstruction节点是什么
ProcessingInstruction（PI）节点是XML文档中形如 <?xml-stylesheet type="text/css" href="style.css"?> 或 <?target data="value"?> 的节点，它不属于元素、文本或注释，而是一种独立的节点类型，Node.nodeType 值为 7。Java DOM默认会保留PI节点，但很多初学者在遍历Document时发现“找不到”它们——根本原因是：PI节点只出现在文档顶层（即Document的直接子节点中），**不会嵌套在Element内部**。
用getFirstChild()或getChildNodes()访问PI节点
必须从Document对象开始找，不能从Element开始。常见错误是调用document.getDocumentElement().getChildNodes()，这只会返回根元素的子节点（通常是Element、Text、Comment），永远不含PI。
- PI节点总是位于
Document的子节点序列中，可能在DocumentType之前、之后，或紧邻xml声明之后（取决于解析器和XML结构） - 推荐用
document.getChildNodes()遍历全部子节点，逐个检查node.getNodeType() == Node.PROCESSING_INSTRUCTION_NODE - 若PI在开头，
document.getFirstChild()可能是它；但不可依赖顺序，尤其跨JDK版本或不同DocumentBuilder实现
Document doc = DocumentBuilderFactory.newInstance().newDocumentBuilder().parse(new InputSource(xmlStream));
NodeList children = doc.getChildNodes();
for (int i = 0; i < children.getLength(); i++) {
Node node = children.item(i);
if (node.getNodeType() == Node.PROCESSING_INSTRUCTION_NODE) {
ProcessingInstruction pi = (ProcessingInstruction) node;
System.out.println("Target: " + pi.getTarget() + ", Data: " + pi.getData());
}
}
为什么getElementsByTagName("*")查不到PI节点
getElementsByTagName() 和 getElementsByTagNameNS() **只匹配Element节点**（nodeType == 1），对PI、Comment、DocumentType等完全忽略。这是W3C DOM规范明确规定的，不是Java实现缺陷。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 试图用
doc.getElementsByTagName("xml-stylesheet")一定返回空NodeList - 没有类似
getProcessingInstructionsByTarget()的内置方法，必须手动遍历getChildNodes() - 如果XML中有多个PI（比如多个
<?php ...?>），只能靠getTarget()字符串匹配筛选
注意setIgnoringElementContentWhitespace(true)不影响PI节点
这个DocumentBuilder设置只控制是否丢弃纯空白的Text节点，对PI节点无任何影响——PI节点始终被保留，无论该设置开或关。但要注意：某些老版本Xerces解析器（如Xerces 2.6）在启用http://apache.org/xml/features/dom/defer-node-expansion时可能跳过PI，建议显式禁用该特性或升级解析器。
立即学习“Java免费学习笔记（深入）”；
真正容易被忽略的是：**PI节点的getData()返回值不包含首尾空格的标准化处理，原始空白全部保留**。例如<?xsl version="1.0" ?>的getData()是" version=\"1.0\" "（含前后空格），需自行trim()后再解析。
