go-email-normalizer 电子邮件地址规范化处理库

go-email-normalizer 是一个用于电子邮件地址规范化的 Golang 库，它可以帮助你处理不同电子邮件提供商的各种格式差异，确保电子邮件地址在比较和存储时的一致性。

主要功能

1. 去除电子邮件地址中的点号（对于某些提供商如Gmail）
2. 去除子地址（如+后面的部分，对于支持该特性的提供商）
3. 将域名转换为小写
4. 处理特定提供商的特殊规则

安装

go get github.com/sendgrid/go-email-normalizer

基本使用示例

package main

import (
	"fmt"
	"github.com/sendgrid/go-email-normalizer/pkg/normalizer"
)

func main() {
	// 创建规范化器实例
	normalizer := normalizer.NewNormalizer()

	// 示例1: 基本规范化
	email := "John.Doe+test@gmail.com"
	normalized := normalizer.Normalize(email)
	fmt.Printf("原始: %s → 规范化: %s\n", email, normalized)
	// 输出: 原始: John.Doe+test@gmail.com → 规范化: johndoe@gmail.com

	// 示例2: 不同域的处理
	email = "Jane.Doe@Example.COM"
	normalized = normalizer.Normalize(email)
	fmt.Printf("原始: %s → 规范化: %s\n", email, normalized)
	// 输出: 原始: Jane.Doe@Example.COM → 规范化: janedoe@example.com

	// 示例3: 非Gmail域的处理
	email = "user.name+tag@otherdomain.com"
	normalized = normalizer.Normalize(email)
	fmt.Printf("原始: %s → 规范化: %s\n", email, normalized)
	// 输出: 原始: user.name+tag@otherdomain.com → 规范化: user.name@otherdomain.com
}

高级用法

自定义提供商规则

package main

import (
	"fmt"
	"github.com/sendgrid/go-email-normalizer/pkg/normalizer"
	"github.com/sendgrid/go-email-normalizer/pkg/provider"
)

func main() {
	// 创建自定义提供商规则
	customRules := map[string]provider.Provider{
		"example.com": provider.NewProvider(true, true), // 去除点和子地址
		"mycompany.com": provider.NewProvider(false, false), // 保留点和子地址
	}

	// 使用自定义规则创建规范化器
	normalizer := normalizer.NewNormalizerWithCustomProviders(customRules)

	email := "first.last+tag@example.com"
	normalized := normalizer.Normalize(email)
	fmt.Printf("自定义规则处理: %s → %s\n", email, normalized)
	// 输出: 自定义规则处理: first.last+tag@example.com → firstlast@example.com

	email = "first.last+tag@mycompany.com"
	normalized = normalizer.Normalize(email)
	fmt.Printf("自定义规则处理: %s → %s\n", email, normalized)
	// 输出: 自定义规则处理: first.last+tag@mycompany.com → first.last+tag@mycompany.com
}

批量处理电子邮件地址

package main

import (
	"fmt"
	"github.com/sendgrid/go-email-normalizer/pkg/normalizer"
)

func main() {
	normalizer := normalizer.NewNormalizer()
	
	emails := []string{
		"John.Doe@gmail.com",
		"Jane.Doe+test@GMAIL.COM",
		"user.name@example.com",
		"first.last+tag@yahoo.com",
	}

	fmt.Println("批量规范化结果:")
	for _, email := range emails {
		normalized := normalizer.Normalize(email)
		fmt.Printf("%-30s → %s\n", email, normalized)
	}
}

性能考虑

go-email-normalizer 在设计时考虑了性能因素，适合在高吞吐量的应用中使用。规范化操作是纯内存计算，不涉及I/O操作。

注意事项

1. 该库主要用于电子邮件地址的规范化，不验证地址的有效性
2. 规范化后的地址可能不适合直接用于发送电子邮件（特别是去除了+标签的情况）
3. 对于非标准电子邮件提供商，建议测试规范化结果是否符合预期

替代方案

如果你需要更多功能，也可以考虑以下替代库：

• github.com/AfterShip/email-verifier - 提供电子邮件验证和规范化功能
• github.com/badoux/checkmail - 简单的电子邮件验证库

go-email-normalizer 专注于电子邮件地址的规范化处理，特别适合需要统一存储或比较电子邮件地址的应用场景。