writeAttribute 默认转义特殊字符但不自动声明命名空间，需配合 writeNamespace；须在 startElement 后、endElement 前调用；三个重载版本行为不同，空值会抛 NPE，务必校验。
writeAttribute 会自动转义特殊字符，但不处理命名空间前缀
writeAttribute 是 XMLStreamWriter 写入元素属性的标准方式，它默认对引号、小于号等做 XML 实体转义（比如把 & 变成 &），这点不用额外担心。但如果你传入带冒号的 prefix:localName 形式，比如 "xsi:type"，它不会自动绑定命名空间——必须提前用 setPrefix 和 writeNamespace 配合声明，否则生成的 XML 会报错或被解析器忽略。
- 只写
writeAttribute("xsi:type", "xs:string")→ 输出xsi:type="xs:string"，但没有xmlns:xsi="..."声明，XML 无效 - 正确做法：先
writeNamespace("xsi", "http://www.w3.org/2001/XMLSchema-instance")，再writeAttribute("xsi:type", "xs:string") - 如果命名空间 URI 拼错、漏调
writeNamespace，解析时常见错误是org.xml.sax.SAXParseException: Prefix "xsi" not declared
writeAttribute 三个重载版本的区别很关键
别只记最短的那个。三个签名行为不同：writeAttribute(String localName, String value) 写无前缀属性；writeAttribute(String prefix, String localName, String value) 写带前缀属性（但不自动声明命名空间）；writeAttribute(String namespaceURI, String localName, String value) 写带命名空间 URI 的属性（推荐用于严格合规场景）。
- 用
writeAttribute("id", "123")→id="123"，安全，适合简单属性 - 用
writeAttribute("xsi", "type", "xs:string")→xsi:type="xs:string"，但需确保xsi已通过writeNamespace绑定 - 用
writeAttribute("http://www.w3.org/2001/XMLSchema-instance", "type", "xs:string")→xmlns:ns1="http://..." ns1:type="xs:string"，由 StAX 实现自动分配前缀，避免手动管理冲突 - 混用不同重载容易导致前缀重复或未声明，尤其在循环写多个命名空间属性时
writeAttribute 必须在 startElement 之后、endElement 之前调用
StAX 是事件驱动流式写入，writeAttribute 只能作用于当前正在打开的元素。如果在 startElement 前调用，会抛 java.lang.IllegalStateException: Invalid state. Expecting START_ELEMENT；如果在 endElement 后调用，则直接抛异常或静默失败（取决于实现）。
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
- 正确顺序：
writeStartElement("book")→writeAttribute("id", "101")→writeCharacters("Java Guide")→writeEndElement() - 错误示例：先
writeEndElement()，再补writeAttribute(...)→ 运行时报IllegalStateException - 嵌套元素中，每个
writeAttribute只属于最近一次未闭合的writeStartElement
空字符串和 null 值传给 writeAttribute 的行为不一致
传 null 给 writeAttribute 多数实现会直接抛 NullPointerException；传空字符串 "" 则合法，生成 attr=""。但要注意某些老版本 Woodstox 或 Aalto 在特定配置下对空值容忍度不同。
立即学习“Java免费学习笔记（深入）”；
- 永远校验变量是否为
null，再决定写入：if (id != null) writer.writeAttribute("id", id); - 如果业务上空值应省略该属性，就不要写；如果语义上需要显式
attr=""，才传"" - 避免依赖默认行为，比如认为
writeAttribute("flag", null)会跳过——它不会，而是崩溃 - 测试时用真实
XMLStreamWriter实例（别用 mock），因为不同底层实现对边界输入的反应可能不同
命名空间绑定时机、重载选择、调用位置、空值防御——这四点漏掉任何一个，都可能让生成的 XML 在下游系统里悄无声息地失效。
