writestartelement 默认不自动写入命名空间；需显式调用 writenamespace 或使用三参数版本并正确设置 prefix、localname 和 namespaceuri。
writeStartElement 会自动写入命名空间吗
不会，writeStartElement 默认只写标签名，不处理命名空间声明。如果你传的是单参数（如 writeStartElement("book")），生成的只是 <book></book>，哪怕你之前调用过 setPrefix 或 writeNamespace，它也不会自动带上 xmlns:xxx 或前缀。
常见错误现象：XML 看起来结构对，但解析时报 “namespace not declared” 或元素被当成无命名空间处理。
- 必须显式调用
writeNamespace（在writeStartElement前或后，但要在该元素内容写入前） - 如果要用带前缀的标签（如
<book></book>），得先setPrefix("ns", "http://example.com")，再用三参数writeStartElement("ns", "book", "http://example.com") - 两参数版本
writeStartElement("ns:book")是非法的——StAX 不接受带冒号的本地名，会抛XMLStreamException
三参数 writeStartElement 的三个字符串到底怎么填
签名是 writeStartElement(String prefix, String localName, String namespaceURI)，顺序不能错，含义很具体：
-
prefix：你要显示的前缀（比如"ns"），可以为null或空字符串；设为null时，标签形如<book xmlns="http://...">></book>（默认命名空间） -
localName：纯标签名，不含冒号，比如"book"，这是必填且不可为空 -
namespaceURI：命名空间 URI 字符串，比如"http://example.com/ns"；设为null表示此元素无命名空间（即使外层有）
容易踩的坑：namespaceURI 为空字符串 "" 和 null 效果不同——前者是“空命名空间”，后者才是“无命名空间”。多数解析器把 "" 当作有效 URI，可能导致意外匹配。
立即学习“Java免费学习笔记（深入）”；
写完 startElement 后立即 writeEndElement 会出什么问题
语法上合法，但容易触发 XMLStreamException: Attempting to write an end element when there is no open start element，尤其在嵌套不匹配或异常提前退出时。
根本原因不是调用顺序本身，而是 XMLStreamWriter 内部维护了一个隐式栈；如果中间漏了 writeStartElement、或某次写入抛异常没清理状态、或重用了未重置的 writer 实例，栈就乱了。
- 务必保证每个
writeStartElement都有对应writeEndElement，且成对出现在同一 try 块中 - 推荐用 try-with-resources 包裹
XMLStreamWriter，但注意它不自动 close 标签——仍需手动配对 - 调试时可临时加
getDepth()打印当前嵌套深度，确认是否为负或跳变
writeStartElement 性能和字符编码有关系吗
没有直接关系。StAX 是基于事件的流式 API，writeStartElement 本身只是往内部缓冲区追加字节序列，不触发编码转换；实际编码由底层 OutputStream 或 Writer 决定（比如传 new OutputStreamWriter(out, "UTF-8")）。
但间接影响明显：如果命名空间 URI 很长（比如含时间戳或随机 ID），每次调用三参数版都会复制整个 URI 字符串，高频写入时 GC 压力会上升。
- 复用相同命名空间时，优先调用
setPrefix+ 单参数writeStartElement，避免重复传 URI - 避免在循环内拼接 URI 字符串传给
writeStartElement，改用预定义常量 - 注意
writeStartElement不做任何 XML 名称校验（比如检查localName是否含非法字符），非法输入会在 flush 或 close 时才报错
命名空间绑定和元素开启是两个独立动作，这点很多人写到一半才发现没生效——不是 API 没用，是忘了那行 writeNamespace。
