应优先使用 setTextContent 修改元素文本内容；setNodeValue 仅对 Text 和 Attr 节点有效，对 Element 节点无效且易掩盖问题，三者须按节点类型严格区分使用。
setTextContent 和 setNodeValue 都能改文本，但行为完全不同
直接说结论：setTextContent 是你该用的；setNodeValue 在文本节点上看似有效，但在 Element 节点上调用基本没用，还容易掩盖问题。
根本原因在于 DOM 规范里，Element 节点的 nodeValue 始终为 null（除非是注释、CDATA 等特殊节点），而 setTextContent 会递归清理子节点并插入新文本节点——这才是“修改元素内容”的正确语义。
-
setNodeValue("abc")对Element节点调用后不报错，但什么都不会发生（返回null，也不抛异常） -
setTextContent("abc")会删掉所有子节点（包括空白文本、换行、子元素），只保留一个纯文本子节点 - 如果你的 XML 里有混合内容（比如
<p>Hello<em>world</em>!</p>），setTextContent会把它变成纯文本"Helloworld!"—— 这是预期行为，不是 bug
想保留子元素只改纯文本？别用 setTextContent
常见场景：你只想更新某个 <name>Alice</name> 里的 “Alice”，但不想动它可能带的属性或注释。这时候如果父节点下除了文本还有别的子节点，setTextContent 就太暴力了。
立即学习“Java免费学习笔记（深入）”；
正确做法是定位到那个**文本子节点**再改：setNodeValue 在 Text 节点上是有效的。
- 先遍历
element.getChildNodes()，找到类型为Node.TEXT_NODE的节点 - 确认它非空、非 whitespace（用
getTextContent().trim().length() > 0判断更稳） - 对那个
Text节点调用setNodeValue("new text") - 如果没找到文本子节点，才考虑用
setTextContent新建一个
示例片段：
NodeList children = element.getChildNodes();
for (int i = 0; i < children.getLength(); i++) {
Node child = children.item(i);
if (child.getNodeType() == Node.TEXT_NODE &&
child.getTextContent().trim().length() > 0) {
child.setNodeValue("updated");
break;
}
}
XML 中的空白和换行也是 Text 节点，别误删
Java DOM 默认不忽略空白，所以格式化过的 XML 里，<tag>\n <child></child>\n</tag> 中的换行和缩进都是独立的 Text 节点。这导致两个坑：
- 用
getChildNodes().item(0)直接取第一个子节点，大概率拿到的是空白文本，不是你要的元素 - 调用
setTextContent后，原来整齐的缩进全没了，输出 XML 变成一行（除非你手动格式化） - 解析时若启用了
DocumentBuilderFactory.setIgnoringElementContentWhitespace(true)，空白文本节点会被跳过——但这个开关只影响解析，不影响后续 DOM 操作逻辑
所以判断“哪个 Text 节点该改”，不能只看位置，得结合 getTextContent().trim() 或节点内容长度。
setNodeValue 在 Attribute 上反而更常用
容易被忽略的一点：setNodeValue 对 Attr 节点是标准用法，而且比 setAttribute("name", "value") 更底层、更可控。
-
element.getAttributeNode("id").setNodeValue("new-id")是合法且推荐的 -
setTextContent在Attr节点上不可用（会抛DOMException） - Attribute 节点的
nodeValue就是它的值，所以setNodeValue行为明确、无副作用
也就是说：Element → 用 setTextContent；Text → 用 setNodeValue；Attr → 用 setNodeValue。三者不能混。
DOM 的节点类型语义很重，不是所有节点都支持同一套方法。写的时候多看一眼 node.getNodeType()，比硬试快得多。
