使用quick_xml结合serde序列化数据时如何添加XML声明

XML声明不需要定义在Rust结构体中，将其排除在结构体外、在序列化流程外层单独追加是quick_xml设计层面推荐的标准方案，不要尝试把声明映射为结构体字段。

• quick_xml的serde适配层从设计上就不处理XML声明的结构体映射：反序列化时遇到<?xml ...?>头会直接跳过，不绑定任何结构体字段，这也是你之前带声明的XML能正常反序列化的原因。如果硬要把声明揉进结构体字段，属于违背库的设计逻辑，后续版本升级极易出现兼容问题。
• XML声明属于XML文档级别的元信息，不属于业务数据结构的组成部分，和业务序列化逻辑解耦单独处理，代码可维护性更高。

不需要改动原有结构体定义，只需要在序列化时先写入声明，再追加结构体序列化的结果即可，示例代码如下：

use quick_xml::{
    se::to_string,
    events::{BytesDecl, Event},
    Writer,
};
use std::io::Cursor;

// 原有结构体定义完全不需要修改
#[derive(Default, PartialEq, Debug, serde::Serialize, serde::Deserialize)]
#[serde(rename = "response", default)]
pub struct Response {
    pub protocol: String,
    pub server: String,
}

fn serialize_with_decl(resp: &Response) -> Result<String, Box<dyn std::error::Error>> {
    // 初始化写入缓冲区
    let mut writer = Writer::new(Cursor::new(Vec::new()));
    // 写入XML声明，可按需调整版本、编码、独立文档属性
    writer.write_event(Event::Decl(BytesDecl::new("1.0", Some("UTF-8"), None)))?;
    // 序列化结构体并追加到缓冲区
    let struct_content = to_string(resp)?;
    writer.get_mut().get_mut().extend_from_slice(struct_content.as_bytes());
    
    // 转换为最终字符串输出
    let full_xml = String::from_utf8(writer.into_inner().into_inner())?;
    Ok(full_xml)
}

如果需要格式化输出带缩进的XML，只需要把to_string替换为带缩进配置的序列化方法即可，写入声明的逻辑完全不变。

Event::Decl是quick_xml底层事件读写API的组成部分，本身不属于serde结构化序列化的流程范畴，不需要、也没法直接嵌入serde的结构体序列化链路中，在序列化入口处统一写入是最简洁的实现方式。

内容的提问来源于stack exchange，提问作者Gmac