Go标准库mime包核心功能是解析、匹配与注册MIME类型,不处理完整邮件或HTTP报文;需配合net/mail、net/http等包使用,主要提供ParseMediaType、IsMedia、TypeByExtension及AddExtensionType等函数。

Go 标准库的 mime 包主要用于 MIME 类型的解析、匹配与注册,但它本身不负责解析完整邮件或 HTTP 报文。真正处理邮件(如 RFC 5322/2045)和 HTTP 内容(如请求头中的 Content-Type)时,需结合 net/mail、net/http 等包协同工作。mime 的核心作用是:解析 MIME 类型字符串(如 "text/html; charset=utf-8"),判断子类型是否匹配(如 IsMedia)、注册自定义类型、以及辅助生成合法的 MIME 头字段。
解析并提取 MIME 类型参数(如 charset、boundary)
mime.ParseMediaType() 是最常用函数,它将完整的 Content-Type 字符串拆解为类型、子类型和参数映射:
- 返回主类型(如
"text")、子类型(如"html")和参数(如map[string]string{"charset": "utf-8"}) - 自动处理引号、空格、转义等 RFC 2045 合法格式,无需手动切分
- 若格式非法,返回错误,应检查后再使用
示例:
content := "multipart/mixed; boundary=\"xyz123\"; charset=utf-8"mtype, params, err := mime.ParseMediaType(content)
// mtype == "multipart/mixed"
// params == map[string]string{"boundary": "xyz123", "charset": "utf-8"}
判断 MIME 类型是否属于某类媒体(如 text/* 或 image/*)
mime.TypeByExtension() 和 mime.MatchExtension() 可根据文件扩展名反查或匹配类型;而更通用的分类判断靠 mime.IsMedia()(Go 1.22+)或手动比对:
立即学习“go语言免费学习笔记(深入)”;
-
mime.IsMedia("text/plain")返回true(属于标准媒体类型) - 对自定义类型(如
"application/vnd.myapp+json"),需用strings.HasPrefix()判断主类型或子类型模式 - 常见场景:HTTP 响应中过滤非文本内容,或邮件附件中跳过二进制部分
配合 net/mail 解析多部分邮件(MIME multipart)
邮件正文常含 multipart/mixed 或 multipart/alternative 结构,net/mail 的 ReadMIMEHeader() 和 multipart.NewReader() 依赖 mime 解析 boundary 和类型:
- 先用
net/mail.ReadMessage()获取邮件头,从中提取Content-Type字段 - 调用
mime.ParseMediaType()得到 boundary 值,再传给multipart.NewReader(r, boundary) - 每个
multipart.Part自带Header,其中part.Header.Get("Content-Type")需再次用mime.ParseMediaType()解析子部分类型
注意:boundary 必须严格匹配(包括引号和空格),mime.ParseMediaType 已正确处理这些细节。
注册自定义 MIME 类型(用于 TypeByExtension)
当系统未识别某扩展名(如 .webp 或 .toml)时,可用 mime.AddExtensionType() 手动注册:
- 注册后,
mime.TypeByExtension(".webp")就能返回"image/webp" - 建议在
init()函数中注册,避免并发问题 - 仅影响
TypeByExtension和ExtensionByType,不影响ParseMediaType
示例:
func init() {
mime.AddExtensionType(".toml", "application/toml")
}










