Element.setText 会清空所有子节点并插入新文本节点，而非仅覆盖文本；适合纯文本节点，混合内容需手动操作Text节点或用clearContent()。
Element.setText 会清空子节点，不是“覆盖文本”
很多人以为 Element.setText("abc") 只是改掉当前节点的文本内容，实际它会先移除所有子节点（包括子 Element、Text、Comment），再插入一个纯文本节点。这意味着：如果你原本有 <name><first>Tom</first><last>Smith</last></name>，调用 nameElement.setText("Jack") 后，<first></first> 和 <last></last> 全没了。
- 只适合纯文本节点（即没有子元素）的场景，比如
<age>25</age> - 若节点本应含混合内容（文本+元素），必须用
element.clearContent()+ 手动添加新Text和Element节点 - DOM 树结构变更后，原子节点引用失效，别在
setText后还试图访问被删掉的子元素
想保留子节点只改文本？得手动操作 Text 节点
Dom4j 不提供“仅更新文本节点内容”的快捷方法。如果节点已有文本子节点（比如 <p>old</p>），正确做法是找到那个 Text 对象并调用其 setText()；如果没有，才新建一个 Text 并 add() 进去。
- 用
element.content()遍历子节点，检查instanceof Text - 优先复用第一个
Text节点（如果有），避免无谓创建 - 注意：
element.getText()返回的是拼接后的字符串，不能反向定位到具体Text节点 - 示例：
for (Object obj : element.content()) { if (obj instanceof Text) { ((Text) obj).setText("new text"); break; } }
setText("") 和 clearContent() 的区别很关键
element.setText("") 会清空全部子节点，再加一个空 Text 节点；而 element.clearContent() 只清空，不加任何东西——结果是节点变成空容器（<tag></tag> 或 <tag></tag>）。
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
- 需要“有文本但为空”（如
<email></email>渲染为<email></email>），用setText("") - 需要彻底干净（比如后续要重新 build 子结构），用
clearContent() - 二者都影响 XPath 查询结果：
//tag/text()在setText("")后仍能匹配到一个空文本节点，而clearContent()后匹配不到
中文或特殊字符乱码？检查 Document 的 encoding 设置
Element.setText() 本身不处理编码，但最终输出 XML 时，如果 Document 创建时没指定 encoding，或写入流时未匹配，就会出现乱码。常见于用 XMLWriter 输出文件却漏设 OutputFormat.setEncoding("UTF-8")。
立即学习“Java免费学习笔记（深入）”；
- 创建 Document 时建议显式指定：
DocumentHelper.createDocument().setXMLEncoding("UTF-8") - 写入文件前，
OutputFormat必须和目标文件编码一致，否则 setText 写进去的中文在保存后变成问号或方块 - 控制台打印正常 ≠ 文件内容正常，务必验证生成的 .xml 文件实际字节
