os.Create + xml.NewEncoder 是最安全组合，因 os.Create 自动启用 O_TRUNC 清空文件，避免 os.OpenFile 缺少该 flag 导致旧内容残留；xml.NewEncoder 支持缩进、流式写入和手动控制 XML 声明，配合正确 xml 标签可精准控制输出结构。
直接用 os.Create + xml.NewEncoder 是最安全、最不容易出错的组合，别碰 os.OpenFile 配错 flag 的写法。
为什么 os.OpenFile 写 XML 文件容易残留旧内容
常见错误是这样写：
f, err := os.OpenFile("data.xml", os.O_CREATE|os.O_WRONLY, 0644)
它缺了 O_TRUNC —— 意味着如果文件已存在，Go 不会清空它，只是从头开始覆盖字节。而 XML 序列化结果变短时（比如字段值变短、结构体少一个元素），文件末尾就会卡住上一轮的残余标签，比如闭合标签重复、属性值拼接错乱，甚至出现非法嵌套。
-
os.OpenFile的 flag 必须显式包含os.O_TRUNC才能保证每次写入前清空文件 -
os.Create内部自动等价于os.O_CREATE | os.O_TRUNC | os.O_WRONLY，更简洁、更难出错 - IDE（如 IntelliJ）对
os.Create生成的文件识别更稳定，不会因残留字节误判编码或结构
如何用 xml.NewEncoder 正确写入结构体
别用 xml.Marshal + os.WriteFile 拼接字符串，那会丢掉缩进、无法流式写入、且不能手动控制 XML 声明位置。
立即学习“go语言免费学习笔记（深入）”；
推荐写法：
f, err := os.Create("output.xml")
if err != nil {
log.Fatal(err)
}
defer f.Close()
enc := xml.NewEncoder(f)
enc.Indent("", " ") // 启用缩进，可选但强烈建议
// 手动写 XML 声明（<code>xml.NewEncoder</code> 不自动生成）
f.WriteString(`<?xml version="1.0" encoding="UTF-8"?>` + "\n")
err = enc.Encode(myStruct)
if err != nil {
log.Fatal(err)
}
-
enc.Indent("", " ")让输出可读，不加也合法，但调试时痛苦指数翻倍 -
xml.NewEncoder不写 XML 声明，必须手动f.WriteString，否则某些解析器（尤其是老系统）可能报错 - 如果结构体字段为空，加
xml:",omitempty"标签可跳过该字段，避免生成空标签
xml: 标签里几个关键后缀的实际效果
结构体字段上的 xml: 标签不是装饰，它直接决定 XML 输出形态：
-
xml:"name"→ 生成<name>value</name> -
xml:"name,attr"→ 生成<tag name="value"> -
xml:",innerxml"→ 字段值作为父元素的纯文本内容，不转义（慎用，需确保内容安全） -
xml:"-,omitempty"→ 完全忽略该字段（连空标签都不生成） -
xml:"parent>child"→ 嵌套路径，生成<parent><child>...</child></parent>
特别注意：xml:",innerxml" 会跳过所有实体转义（<、& 等原样输出），如果字段来自用户输入，必须提前过滤或改用普通字段 + xml.EscapeText。
权限和路径问题：写入失败的常见盲区
文件写入失败经常不是逻辑问题，而是环境问题：
- 目标路径的父目录不存在时，
os.Create会直接报no such file or directory，需先调用os.MkdirAll(filepath.Dir(path), 0755) -
os.WriteFile或os.Create的权限参数（如0644）受系统umask影响，实际落盘权限是perm &^ umask；在 CI 或容器中 umask 常为0022，所以传0666最终可能是0644 - Windows 下路径分隔符要用
filepath.Join，硬写"dir/file.xml"在某些环境会失败
最易被忽略的是：XML 写入本身成功，但后续程序读取时因 BOM、换行符或隐藏控制字符解析失败——务必确认写入后文件开头确实是 <?xml，且无不可见字符。
