Java DocumentBuilder默认忽略Comment节点，需显式调用setIgnoringComments(false)并遍历childNodes判断Node.COMMENT_NODE类型，用getNodeValue()获取注释内容。
Comment节点默认被DOM解析器忽略
Java的DocumentBuilder默认不会把XML注释当作节点加载进DOM树，所以调用getElementsByTagName或遍历childNodes时根本看不到Comment——不是你代码写错了，是解析器主动扔掉了。
关键在解析前设置setIgnoringElementContentWhitespace(false)没用，真正起作用的是setCoalescing(false)和更关键的setIgnoringComments(false)：
-
setIgnoringComments(false)必须显式调用，JDK默认为true -
setCoalescing(false)避免文本节点合并（间接影响Comment位置） - 即使设置了，
Comment仍属于Node.COMMENT_NODE类型，不能用Element方法访问
如何安全获取Comment节点内容
拿到Document后，不能依赖getElementsByTagName("comment")（XML里没有<comment></comment>标签），得靠遍历+类型判断：
- 用
Node.getChildNodes()逐层遍历，对每个Node检查node.getNodeType() == Node.COMMENT_NODE - 用
node.getNodeValue()取注释文本（注意：不是getTextContent()，后者对Comment返回null） - 如果注释嵌在元素内部（比如
<tag><!-- desc -->text</tag>），它会作为tag的子节点出现，顺序取决于原始XML排版
示例片段：
DocumentBuilder builder = factory.newDocumentBuilder();
builder.setIgnoringComments(false); // 必须加
Document doc = builder.parse(new InputSource(new StringReader(xml)));
NodeList nodes = doc.getDocumentElement().getChildNodes();
for (int i = 0; i < nodes.getLength(); i++) {
Node node = nodes.item(i);
if (node.getNodeType() == Node.COMMENT_NODE) {
String commentText = node.getNodeValue(); // ✅ 正确取值方式
}
}
常见错误：把Comment当Element处理
看到<!-- version=1.2 -->就下意识想用((Element)node).getAttribute("version")？这会直接抛ClassCastException。
立即学习“Java免费学习笔记（深入）”；
-
Comment是Node子类，不是Element，强制转型必崩 - 注释里的结构（如
key=value）需手动解析，DOM不提供原生支持 - 若XML含CDATA块，其内容也不会自动注入Comment节点，两者完全独立
- 不同JDK版本对空白换行的处理略有差异，建议用
trim()清理getNodeValue()结果
兼容性与性能提醒
启用setIgnoringComments(false)几乎无性能损耗，但要注意：
- Android API 28+ 的
DocumentBuilder默认已关闭注释忽略，旧版本仍需手动设 - 使用
javax.xml.parsers.DocumentBuilder时安全；但换成org.w3c.dom.ls.DOMImplementationLS加载方式，行为可能不同 - 如果XML来自不可信来源，大量注释可能撑大DOM内存占用，生产环境建议限制单文件注释总数
注释不是元数据容器，DOM里它只是带类型标记的纯文本节点——想靠它存配置或Schema信息，得自己解析字符串，别指望DOM自动帮你结构化。
