本文详解如何在 go 中正确使用 encoding/xml 包生成带 media rss（mrss）命名空间的 rss 2.0 xml 文档，重点解决 xmlns:media 属性因字段名与 xml 标签名不一致导致的语法错误问题。
本文详解如何在 go 中正确使用 encoding/xml 包生成带 media rss（mrss）命名空间的 rss 2.0 xml 文档，重点解决 xmlns:media 属性因字段名与 xml 标签名不一致导致的语法错误问题。
在构建聚合媒体内容（如播客、视频源或富媒体新闻源）的 RSS 订阅时，标准 RSS 2.0 往往不足以描述音视频元数据（如缩略图、时长、内容类型等）。此时需引入 Media RSS（MRSS）扩展规范，其核心是通过 XML 命名空间 xmlns:media="http://search.yahoo.com/mrss" 注册媒体相关元素。而 Go 的 encoding/xml 包虽强大，但在处理含冒号的 XML 属性（如 xmlns:media）时，初学者常因混淆结构体字段名与 XML 序列化标签而报错。
关键在于：XML 标签名 ≠ Go 结构体字段名。xml 标签中的 xmlns:media,attr 是序列化规则，它告诉 Go “将该字段值输出为名为 xmlns:media 的 XML 属性”，但结构体中对应的字段名必须是合法的 Go 标识符（不能含冒号）。因此，你不能写 Xmlns:media: 这样的字段名——这是语法错误；而应定义一个普通字段（如 Xmlns），再通过 xml:"xmlns:media,attr" 显式绑定其输出行为。
以下是一个完整、可运行的示例：
package main
import (
"encoding/xml"
"fmt"
"os"
)
type Channel struct {
Title string `xml:"title"`
Description string `xml:"description"`
Item []Item `xml:"item"`
}
type Item struct {
Title string `xml:"title"`
Description string `xml:"description"`
MediaContent struct {
URL string `xml:"url,attr"`
Type string `xml:"type,attr"`
Length string `xml:"fileSize,attr"`
} `xml:"media:content"`
}
type RSS struct {
XMLName xml.Name `xml:"rss"`
Xmlns string `xml:"xmlns:media,attr"` // ✅ 正确：字段名 Xmlns 合法，xml 标签指定输出为 xmlns:media
Version string `xml:"version,attr"`
Channel Channel `xml:"channel"`
}
func main() {
rss := &RSS{
Version: "2.0",
Xmlns: "http://search.yahoo.com/mrss", // ✅ 正确：赋值给字段 Xmlns，而非试图构造非法字段名
Channel: Channel{
Title: "My MRSS Feed",
Description: "A sample feed with media extensions",
Item: []Item{{
Title: "Episode 1",
Description: "First podcast episode",
MediaContent: struct {
URL string `xml:"url,attr"`
Type string `xml:"type,attr"`
Length string `xml:"fileSize,attr"`
}{
URL: "https://example.com/ep1.mp3",
Type: "audio/mpeg",
Length: "12345678",
},
}},
},
}
output, err := xml.MarshalIndent(rss, "", " ")
if err != nil {
panic(err)
}
fmt.Printf("%s\n", output)
}运行后将输出符合 MRSS 规范的 XML 片段：
<rss version="2.0" xmlns:media="http://search.yahoo.com/mrss">
<channel>
<title>My MRSS Feed</title>
<description>A sample feed with media extensions</description>
<item>
<title>Episode 1</title>
<description>First podcast episode</description>
<media:content url="https://example.com/ep1.mp3" type="audio/mpeg" fileSize="12345678"/>
</item>
</channel>
</rss>⚠️ 注意事项：
- 字段名必须遵循 Go 命名规范（字母/下划线开头，仅含字母、数字、下划线），不可包含 :、- 等 XML 特殊字符；
- xml:"..." 标签中的名称（如 xmlns:media）是纯字符串，仅用于序列化/反序列化控制，与字段名完全解耦；
- 若需支持多个命名空间（如 xmlns:itunes），只需添加对应字段并配置 xml:"xmlns:itunes,attr" 即可；
- 使用 xml.MarshalIndent 可提升可读性，生产环境建议配合 xml.Header 添加 XML 声明（如 <?xml version="1.0" encoding="UTF-8"?>）；
- 所有导出字段（首字母大写）才可被 xml 包访问；非导出字段将被忽略。
掌握这一映射机制，即可灵活构建任意复杂度的 MRSS、Atom 或自定义 XML 格式，是 Go 开发者对接媒体平台、播客目录及内容分发系统的关键基础能力。
