IDNA双向转换需用golang.org/x/net/idna，默认IDNA2008+UTS#46；必须先清洗输入、分离纯域名再转换，避免直接处理URL或邮箱全量字符串；入库存ToASCII小写结果，显示用ToUnicode。
用 idna.ToASCII 和 idna.ToUnicode 做双向转换
Go 标准库不直接支持 IDN 处理，必须用 golang.org/x/net/idna。它默认遵循 IDNA2008 + UTS #46 兼容模式，能正确处理中文域名（如 例子.中国）和边界 case（如带连字符、大小写混合的 XN--EXAMPLE-XXA）。
常见错误现象：直接对用户输入的域名调用 idna.ToASCII 而不先做基础清洗，导致 invalid byte in DNS label 或 label contains prohibited character 错误。
实操建议：
- 始终先用
strings.TrimSpace清除首尾空格，再检查是否为空字符串 - 对邮箱地址中的域名部分（
@后）单独提取后转换，不要整邮箱传入ToASCII - 若需兼容老旧系统（如只认 IDNA2003），可显式构造
idna.Options{Strict: true}，但多数场景应保持默认宽松行为 - 示例：
package main import ( "fmt" "strings" "golang.org/x/net/idna" ) func main() { domain := strings.TrimSpace("例子.中国") ascii, err := idna.ToASCII(domain) if err != nil { panic(err) } fmt.Println(ascii) // xn--fsq093n.xn--fiqs8s }
校验前必须分离域名与协议/路径
直接对 https://例子.中国/path 调用 idna.ToASCII 会失败，因为该函数只接受纯域名（不含 scheme、port、path、query）。很多开发者卡在这一步，误以为是编码问题，其实是输入格式不对。
立即学习“go语言免费学习笔记（深入）”；
使用场景：API 接收用户提交的网站 URL，需提取并标准化其域名部分用于存储或比对。
实操建议：
- 用
net/url.Parse解析完整 URL，取u.Hostname()（自动剥离端口） - 注意
u.Host包含端口（如例子.中国:8080），需额外用strings.SplitN(u.Host, ":", 2)拆分 - 若输入可能是纯域名（无协议），可用正则粗筛：
^([a-zA-Z0-9\u4e00-\u9fa5.-]+)$，但别依赖它做最终校验 - 对
localhost、127.0.0.1等非公网域名，ToASCII会原样返回，不报错也不转码 —— 这是设计使然，不是 bug
validator.v9 的 email 标签不处理 Punycode
validator.v9 的 email 校验只跑正则 ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$，它完全不识别 xn-- 开头的 Punycode 域名，更不会尝试解码。用户填 test@例子.中国 会被直接判为非法。
性能影响：自己加一层 ToASCII 转换再校验，耗时增加约 0.02ms（实测），远低于 DNS 查询或 SMTP 连接开销，可忽略。
实操建议：
- 在 validator 自定义校验函数中，先用
strings.SplitN(field.String(), "@", 2)提取域名部分 - 对域名调用
idna.ToASCII，成功后再走原有 email 正则（此时域名已是 ASCII） - 若
ToASCII报错（如含非法字符），直接返回 false，不必继续正则 - 注意：不要在结构体 tag 里写
validate:"email"就完事，必须配合前置预处理逻辑
容易被忽略的大小写与缓存陷阱
idna.ToASCII 输出强制小写（如 XN--EXAMPLE-XXA → xn--example-xxa），但 idna.ToUnicode 对输入大小写不敏感。这导致一个隐蔽问题：若你把用户原始输入（含大写 XN--）存进数据库，又用 ToUnicode 显示给前端，看起来正常；但下次拿这个显示值再转 ASCII 时，得到的是全小写，跟原始存的不一致。
复杂点在于：DNS 协议本身不区分大小写，但某些中间件（如 CDN、WAF）可能做精确字符串匹配。所以“一致性”比“正确性”更关键。
实操建议：
- 入库前统一用
ToASCII标准化，并存小写结果 —— 不要存原始输入 - 显示给用户时用
ToUnicode，但别把它当“原始值”回传给后端 - 避免在 HTTP header、cookie 值里直接拼接
ToUnicode结果，某些老客户端可能无法处理 UTF-8 字节流 - 测试时务必覆盖
XN--EXAMPLE-XXA、xn--example-xxa、例子.中国三者互转，确认闭环无损
