MailKit库中MailboxAddress参数顺序问题解析

在使用MailKit库进行SMTP邮件发送时，开发者可能会遇到"SmtpCommandException: Syntax error in parameters or arguments"的错误。这个错误通常是由于MailboxAddress构造函数的参数顺序使用不当导致的。

MailboxAddress构造函数的设计需要特别注意参数顺序。正确的参数顺序应该是：

new MailboxAddress(displayName, address)

而不是：

new MailboxAddress(address, displayName)

这个设计决策背后有几个技术考量：

1. 一致性原则：大多数邮件库和协议实现都采用"显示名称在前，地址在后"的顺序，保持一致性有助于开发者记忆和使用。

2. 防止误用：早期版本曾尝试提供仅接受地址的构造函数重载，但发现开发者容易误以为该构造函数会自动解析包含名称和地址的完整字符串，因此移除了这种设计。

3. 明确性：强制要求两个参数可以避免开发者忽略显示名称的设置，提高代码可读性。

对于邮件正文的设置，MailKit提供了两种方式：

1. 使用字符串直接指定MIME类型：

new TextPart("plain") { Text = "邮件内容" }

2. 使用TextFormat枚举（更推荐）：

new TextPart(TextFormat.Plain) { Text = "邮件内容" }

在实际开发中，建议开发者：

1. 仔细检查MailboxAddress的参数顺序
2. 使用TextFormat枚举而非字符串常量来指定文本类型
3. 遇到SMTP错误时，首先检查地址格式是否正确
4. 对于复杂的邮件需求，可以考虑封装自己的辅助方法来简化常用操作

理解这些设计决策和最佳实践，可以帮助开发者更高效地使用MailKit库进行邮件发送操作，避免常见的配置错误。