邮箱、电话与邮政编码字段校验

目标与适用范围

按国家或地区检查邮箱、电话号码和邮政编码的语法，支持单值与批量记录，并明确区分格式结果与邮箱投递、号码接通及地址存在性。
本指南将当前任务范围转化为可复核的交付结果。请保留源文件、中间产物和关键判断，让后续协作者能够理解检查了什么以及为什么这样处理。

准备证据并作出选择

• 在原始值旁保留规范化值或复核值，确保失败记录能够追溯到来源字段。

• 为电话和邮政编码提供国家或地区信息；缺少上下文时标记为待确认，不要擅自猜测规则。

• 先决定处理单个值还是批量列，并约定空值、重复值和需要人工复核的记录如何保存。

• 决策点: 输入是单个值还是一组记录？. 表单字段和例外记录使用单值验证器；导入的邮箱或电话列使用批量验证器，以便保留逐行失败信息。

• 决策点: 应使用哪条国家或地区规则？. 国家混合时使用全球电话和邮政编码检查；只有明确属于美国 ZIP 或 ZIP+4 的字段才使用美国专用校验器。

• 决策点: 通过格式检查后可以得出什么结论？. 通过仅表示语法或受支持的模式匹配成功。投递性、电话可接通性、地址存在性以及不明确的地区情况必须另行验证或人工处理。

按步骤完成工作流

1. 检查单个联系人字段

先检查一个邮箱和电话号码，保留原始输入、可用的规范化显示，以及任何拒绝或质量提示的具体原因。 使用 email-validator, phone-validator.

2. 应用国家和邮政编码规则

按国家上下文检查电话并选择匹配的邮政规则；只有美国 ZIP 或 ZIP+4 才使用美国专用工具，不要从编码通过推断完整地址。 使用 global-phone-validator, global-postal-code-validator, us-zip-code-validator.

3. 检查批量数据并分流例外

对导入的邮箱和电话列运行批量工具，保存行号与失败原因，再将空值、国家不明和边界结果交给人工复核。 使用 batch-email-validator, batch-phone-validator, global-postal-code-validator.

交付前验收结果

• 每个非空邮箱、电话和邮政编码都按选定的国家或地区规则分类；拒绝的记录保留具体原因。
• 单值和批量数据使用对应验证器，并保留原始行号或字段路径，便于修正后重新检查。
• 美国 ZIP 规则不会与其他地区规则混用；无法确定地理范围的值必须标记为未解决。
• 最终记录明确说明，格式通过不代表邮箱可投递、号码可接通、字段属于本人、地址存在或货物能够送达。

常见问题

• 邮箱格式正确是否代表一定能投递？ 不代表。它只支持语法或基础质量判断，不能证明邮箱存在、接受邮件、属于目标用户或最终能够收到邮件。
• 什么时候应该使用批量验证器？ 列表或导入列使用 batch-email-validator 和 batch-phone-validator；表单中的单个字段、修正值或需要细查的记录使用单值工具。
• 邮政编码通过说明地址有效吗？ 不说明。它只表示编码符合受支持国家或地区的模式，不能证明街道地址存在、完整或可以接收货物。