Java创建带命名空间的XML文档需用DOM或StAX API显式声明和绑定命名空间URI：根元素须调用setAttributeNS声明xmlns前缀，子元素用createElementNS创建，避免字符串拼接；StAX中通过writeNamespace和writeStartElement自动管理前缀与URI映射。
Java创建带命名空间的XML文档，核心是使用DOM或StAX等标准API正确声明和应用命名空间URI，而非仅靠字符串拼接。关键在于：命名空间前缀需通过setAttributeNS或createElementNS显式绑定，且根元素必须声明该命名空间（如xmlns:ns="http://example.com/ns"），子元素才能合法使用前缀。
使用DOM API创建带命名空间的XML
DOM是最常用方式，需注意命名空间相关方法与普通属性/元素的区别：
- 用
Document.createElementNS(namespaceURI, qualifiedName)创建带命名空间的元素，例如doc.createElementNS("http://example.com/order", "order:Order") - 用
Element.setAttributeNS(namespaceURI, qualifiedName, value)设置命名空间属性，如orderEl.setAttributeNS("http://www.w3.org/2000/xmlns/", "xmlns:order", "http://example.com/order") - 根元素必须显式声明默认命名空间或带前缀的命名空间，否则子元素即使调用
createElementNS也不会在序列化时显示前缀 - 输出时建议使用
Transformer并设置OutputKeys.INDENT和OutputKeys.OMIT_XML_DECLARATION等参数控制格式
使用StAX（Streaming API）更轻量地写入命名空间
StAX适合生成大文档或对性能敏感场景，通过XMLStreamWriter直接写入命名空间声明：
- 调用
writeStartElement("order", "Order", "http://example.com/order")自动关联前缀与URI - 用
writeNamespace("order", "http://example.com/order")显式写出xmlns:order="..."声明（通常在根元素内调用一次） - 子元素若在同一命名空间下，可只传本地名（如
writeStartElement("Item")），writer会自动复用已声明的前缀 - 避免手动写
xmlns字符串——应交由writer管理，否则易出错或重复声明
常见坑点与验证建议
命名空间容易出错，生成后务必验证是否符合预期：
立即学习“Java免费学习笔记（深入）”；
- 不要用
Element.setAttribute("xmlns:ns", "...")——这会创建普通属性，不是命名空间声明；必须用setAttributeNS("http://www.w3.org/2000/xmlns/", "xmlns:ns", "...") - DOM中若未在根元素调用
setAttributeNS声明前缀，即使子元素用createElementNS，序列化结果可能无前缀或报错 - 用
javax.xml.validation.Validator配合XSD验证命名空间是否被正确定义和使用 - 用
XMLUnit或简单解析再查询getElementsByTagNameNS确认元素是否归属目标命名空间
不复杂但容易忽略细节，重点就是“声明在根、创建用NS、写入靠API”。
