简介：这是一份基于C++与Visual Studio 2008实现的SMTP邮件发送客户端程序，面向需要理解邮件传输协议或希望在实际项目中集成邮件功能的开发者。程序完整展示了SMTP的核心交互流程：连接25号端口、HELO/EHLO握手、AUTH身份验证、MAIL FROM与RCPT TO指定收发件人、DATA传输正文以及QUIT退出等环节，源码按SMTP类、邮件类、网络连接类等模块划分，便于逐段研读和复用。压缩包共42个文件，其中13个头文件与12个C++源文件构成主要代码，另含VS工程配置文件、编译好的可执行示例以及MIME/Base64编码相关单元，整体仅1.23MB，适合快速下载分析。已有131人学习该资源。通过研读这套程序，可以掌握基于winsock的TCP通信、服务器响应处理、MIME邮件构造与解析等技能，也可在此基础上扩展附件上传、HTML邮件、多收件人管理等更复杂的邮件功能。

1. SMTP.rar 与 C++ 邮件发送：为什么在 Visual Studio 里这件事值得自己写

在一台没有公网 SDK、不允许随便装第三方组件的工控机上，监控程序温度越限后需要自动发一封告警邮件，这是很多用 C++ 写上位机的同事早晚会遇到的需求。有人甩过来一个叫 SMTP.rar 的压缩包，里面通常是 C++ 写的邮件发送源码，但解压后很多人看一眼AUTH LOGIN、DATA、base64就放回去了——因为 SMTP 协议长得像上世纪产物，确实不像能一眼吃透的东西。这篇文章就用 Visual Studio（也就是常说的 VS）里的 C++ 工程，把一个最小可用的 SMTP 邮件发送方案从头讲到能上线，覆盖协议流程、代码骨架、参数设置和最常见的几个坑。适合要给上位机加告警通知、内网报表推送的 C++ 开发者。

2. 吃透 SMTP 协议再动手：命令序列、返回码与 AUTH 认证流程

2.1 SMTP 会话的三个阶段：从 TCP 连接到 QUIT

SMTP 的底层就是 TCP 加文本命令，客户端连上 25 或 587 端口后，双方通过一行一行的 ASCII 命令交互。整段会话可以分为三个阶段：第一阶段是连接建立，服务器返回220欢迎语；第二阶段是事务处理，包含认证、发件人、收件人、邮件内容；第三阶段是QUIT收尾。很多从 HTTP 转过来的开发者容易把邮件发送当成“调用一次 API”，实际上它更像和服务器对话：你每说一句，对方给一个三数字的回应码，你说错一句，对话就中断。

最常见的命令序列是：EHLO打招呼（不是 HELO，后者拿不到扩展能力）、AUTH LOGIN开始认证、MAIL FROM声明发件人、RCPT TO声明收件人、DATA进入内容输入模式、以一行单独的点号结束内容、最后QUIT。注意带外数据的边界也在这里：DATA模式里如果邮件正文某一行恰好是一个点，需要按 SMTP 规范把它转成两个点，否则服务器会提前认为内容结束。

2.2 返回码决定流程走向：读懂关键响应码

SMTP 的响应码是三位数字，第一位代表类别：2xx 是成功，3xx 是要你继续输入，4xx 是临时失败，5xx 是永久失败。写代码时不能只看“连上了”就往下冲，每一行回复都必须检查。

调试时我会把每一行响应原样打印出来，很多诡异问题一眼就能定位。比如返回码第一位数是 5，就不用再重试了，重试只会让服务器把你当成垃圾流量；第一位数是 4，则可以稍等几秒重发。

2.3 认证方式：AUTH LOGIN 与 AUTH PLAIN 的取舍

现代邮件服务器普遍要求先认证再发信。AUTH LOGIN是两步式：服务器返回334 VXNlcm5hbWU6后，客户端依次发送 base64 编码的用户名和密码，最后拿到235。AUTH PLAIN则是一次性把\0用户名\0密码整体做 base64 后发送。前者兼容性好，几乎所有服务器都认；后者命令更短，但字符串拼接时容易混入 C 字符串的截断问题。

常见的选择标准是：服务器EHLO响应里写了什么就优先用什么。比如响应里带AUTH LOGIN PLAIN，两个都可以；如果只写了AUTH LOGIN，就老老实实用 LOGIN。还要注意 base64 只是编码不是加密，在明文 TCP 上发出去等于裸奔，生产环境务必叠加 TLS。这点几乎所有新手都会忽略，我在第四、五章会专门讲。

3. 在 Visual Studio 里跑通最小发送：Winsock 工程与代码骨架

3.1 创建 VS 工程与链接库设置

用 VS2022 或 VS2019 都可以，新建一个控制台应用或空项目，把默认的预编译头关掉。SMTP 走的是 TCP，而 Windows 下写 TCP 要用 Winsock，所以第一步不是写 SMTP 命令，而是把ws2_32.lib链进来。常见的做法有两种：一种是在项目属性里找到“链接器 → 输入 → 附加依赖项”，手动填入ws2_32.lib；另一种更省事，直接在源码顶部写一行#pragma comment(lib, "ws2_32.lib")。

还有一个容易被新手忽略的选项：项目属性里的字符集。我习惯把工程设成“使用多字节字符集”，这样后面处理 SMTP 响应和构造命令字符串时，std::string和 socket 的send/recv之间不需要来回转宽字符。如果坚持用 Unicode 字符集，那么所有传给send的字符串都要先转 UTF-8 或 ANSI，代码会平白多出一层WideCharToMultiByte的转换，没有任何收益。

3.2 最小发送代码：连接、EHLO、认证、发送、QUIT

下面是可以在 VS 里直接编译的控制台示例。这段代码故意省略了错误判断，目的是先让你看清完整的协议流程；每行命令后都标了期望的返回码。

// MailSenderDemo.cpp —— VS2022 控制台工程，演示 SMTP 明文会话 // 已用 pragma 自动链接 ws2_32.lib，无需在属性页手动配置 #pragma comment(lib, "ws2_32.lib") #include <winsock2.h> #include <ws2tcpip.h> #include <iostream> #include <string> // 读取一行响应，读到换行符为止 static std::string ReadLine(SOCKET sock) { std::string line; char ch; while (recv(sock, &ch, 1, 0) == 1) { if (ch == '\n') break; line += ch; } if (!line.empty() && line.back() == '\r') line.pop_back(); return line; } // 发送一行 SMTP 命令，统一补上 CRLF static void SendLine(SOCKET sock, const std::string& line) { std::string data = line + "\r\n"; send(sock, data.c_str(), (int)data.size(), 0); } int main() { WSADATA wsa; WSAStartup(MAKEWORD(2, 2), &wsa); SOCKET sock = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP); sockaddr_in addr{}; addr.sin_family = AF_INET; addr.sin_port = htons(25); // 内网 SMTP 服务器端口 inet_pton(AF_INET, "192.168.1.50", &addr.sin_addr); connect(sock, (sockaddr*)&addr, sizeof(addr)); std::cout << "C: " << ReadLine(sock) << std::endl; // 220 欢迎语 SendLine(sock, "EHLO mail.local"); // 打招呼 std::cout << "C: " << ReadLine(sock) << std::endl; // 250 SendLine(sock, "AUTH LOGIN"); // 开始认证 std::cout << "C: " << ReadLine(sock) << std::endl; // 334 SendLine(sock, "dXNlcg=="); // base64("user") std::cout << "C: " << ReadLine(sock) << std::endl; // 334 SendLine(sock, "cGFzcw=="); // base64("password") std::cout << "C: " << ReadLine(sock) << std::endl; // 235 认证成功 SendLine(sock, "MAIL FROM:<alarm@example.com>"); ReadLine(sock); // 250 SendLine(sock, "RCPT TO:<ops@example.com>"); ReadLine(sock); // 250 SendLine(sock, "DATA"); ReadLine(sock); // 354 SendLine(sock, "From: <alarm@example.com>"); SendLine(sock, "To: <ops@example.com>"); SendLine(sock, "Subject: Temperature Alarm"); SendLine(sock, ""); SendLine(sock, "CPU temperature exceeded 85C."); SendLine(sock, "."); // 结束内容 ReadLine(sock); // 250 接收 SendLine(sock, "QUIT"); ReadLine(sock); // 221 closesocket(sock); WSACleanup(); return 0; }

这段代码逻辑很直白：ReadLine一次读一个字节拼成一行，SendLine统一在每行后面补\r\n。SMTP 对换行符有严格规定，必须是 CRLF，用std::endl在 Windows 下虽然也是\r\n，但字符串拼接时稍不注意就会漏掉\r，所以我在SendLine里强制补齐。

关键参数有两处：端口 25 是内网服务器常用端口，换成公网邮箱一般是 587；inet_pton里的 IP 要改成实际的 SMTP 服务器地址。如果服务器要求先STARTTLS，这段明文代码会在AUTH LOGIN那一步收到530，这是正常的，不是代码写错了。

3.3 把发送逻辑封装成 MailSender 类

跑通上面的过程后，下一步就是把它封装成一个可复用的类，否则每次发邮件都要重新写一遍连接、认证、拼接内容的重复代码。常见的做法是暴露一个SendMail方法，内部按状态机推进：连接 → EHLO → 认证 → 发件人 → 收件人 → DATA → 内容 → QUIT，任何一步返回非预期代码就抛出带响应码的异常。

类里至少要有这几个参数：server、port、username、password、from、to、subject、body。还要单独留一个timeout字段，这个参数我放在第四章讲，因为绝大多数“邮件发不出去”的故障，最后都跟超时设置有关。封装完之后，业务代码里只需要调一行，上位机告警、报表推送、定时任务都能复用同一套连接逻辑。

4. 把参数调到能上线：端口、超时、中文编码与 TLS 接入

4.1 端口选择：25 / 465 / 587 的适用场景

很多公网服务器和云厂商机房会封掉 25 端口，因为你用 25 端口发信容易被外人借去发垃圾邮件。内网没有封口问题，但各企业邮件系统的行为也未必一致，所以端口必须做成可配置项而不是写死在代码里。

实际选型时我一般优先用 587。原因很简单：它要求先认证再发信，服务器端也普遍开放；465 需要代码在连接建立后立刻做 TLS 握手，把协议流程搞复杂了；25 在国内机房几乎等于不可用。

4.2 超时与重试参数：别让程序卡死在等待里

recv默认是阻塞的，如果服务器没响应，线程会一直挂在那里。所以代码里必须给阻塞调用加时限。最简单的做法是setsockopt设置接收超时：

int timeoutMs = 30000; setsockopt(sock, SOL_SOCKET, SO_RCVTIMEO, (const char*)&timeoutMs, sizeof(timeoutMs));

设了超时之后，recv在约定时间内收不到数据会返回SOCKET_ERROR，WSAGetLastError()是WSAETIMEDOUT。这时代码要做的是记录日志并主动QUIT或直接closesocket，然后按退避策略重试。常见的做法是重试三次，间隔 1、2、4 秒；超过三次就放弃，并把失败原因写进日志文件。

连接阶段的阻塞也要处理。connect默认会等很久，我一般用select给它一个 10 秒的连接超时：先connect返回SOCKET_ERROR且WSAEWOULDBLOCK，再用select等FD_WRITE事件，判断连接是否可用。没有这一步的话，服务器 IP 不通时程序能卡几分钟。

4.3 中文标题与正文的编码：不做 MIME 编码就等着乱码

邮件标题默认只支持 ASCII。要发中文标题，必须按 MIME 标准编码成=?UTF-8?B?base64内容?=的格式。比如标题“温度告警”的 UTF-8 字节先做 base64，再套上=?UTF-8?B?....?=。正文部分则要在DATA头里声明字符集。

常见做法是在邮件头部加两行：Content-Type: text/plain; charset="utf-8"和Content-Transfer-Encoding: base64，正文整体用 base64 编码传输，这样避免正文中途出现换行符或非法字符。注意 base64 编码可以用 Windows 自带的CryptBinaryToStringA，也可以用 OpenSSL 的EVP_EncodeBlock，别自己去实现轮子。还有一个细节：编码后的 base64 字符串可能包含\0，在 C++ 里用std::string接收时不要调用c_str()后按 C 字符串打印，否则长度会不对。

4.4 TLS 接入：OpenSSL 与 Schannel 的取舍

生产环境里用户名密码如果直接明文走 25 端口，任何人都能抓包解出 base64 背后的真实账号。所以要么用 465 端口做隐式 TLS，要么用 587 端口做 STARTTLS。

在 VS 里接入 TLS，常见的做法是装 OpenSSL。Windows 下快捷方式是用 vcpkg 安装：

vcpkg install openssl:x64-windows

装完后在 VS 项目属性里把 vcpkg 的 include 和 lib 路径加进去，然后代码里把原来的send/recv换成SSL_write/SSL_read，连接建立后先做SSL_connect握手再发EHLO。如果不想引入第三方库，也可以用 Windows 自带的 Schannel（SSPI），但 SSPI 的上下文初始化、缓冲管理非常繁琐，我一般只在对方明确要求不装任何依赖时才用它。STARTTLS 的流程是：先明文发EHLO，然后发STARTTLS命令，收到220后升级套接字为 TLS，之后再重新发一次EHLO，后面所有命令都走加密通道。

注意：465 端口是连接后直接握手，587 是发完 EHLO 再 STARTTLS，两者顺序完全不同，代码里要区分清楚，否则 TLS 握手时机错了服务器直接断链。

5. SMTP 发送避坑手册：5 个翻车现场的排查路径

5.1 编译期报 LNK2019：socket、connect 找不到

现象：VS 编译时报一堆LNK2019: unresolved external symbol _imp_socket，或者_imp_connect、_imp_recv这类符号无法解析。原因是ws2_32.lib没有链接进来。Winsock 的 API 不在默认的 C 运行时库里。

解决：在#include <winsock2.h>之前不要加#include <windows.h>，否则头文件顺序冲突；链接库用#pragma comment(lib, "ws2_32.lib")放在源文件顶部即可。如果项目里用到了ws2tcpip.h，不用额外链接ws2_32以外的库。

5.2 运行时卡死： ReadLine 等不到回复

现象：程序走到connect后一直卡在某个ReadLine，很久没有输出；或者过一会儿直接报超时错误。原因有两个：一是没有设置SO_RCVTIMEO，recv无限期阻塞；二是服务器因为客户端发来了它不认识的命令，其实已经返回了错误码，但客户端还在等待下一行响应。

解决：先设置接收超时，再把ReadLine改成超时能感知的分批接收逻辑：recv返回0表示对端关闭，返回SOCKET_ERROR且WSAETIMEDOUT表示超时，这两种情况都要立即退出并记录现场。调试时可以把每次ReadLine的结果打印出来观察，通常在AUTH LOGIN后卡住，基本就是 TLS 没有提前做。

5.3 认证失败：535 与 530 背后是同一个坑

现象：账号密码明明正确，服务器回复535 5.7.8 Authentication credentials invalid。或者在没有加密的情况下回复530 5.7.0 Must issue a STARTTLS command first。原因通常是两种：服务器强制要求加密通道内才能做认证；或者密码里包含特殊字符，在字符串拼接时被截断了。

解决：先看返回码是不是 530，是的话先补 STARTTLS。再看代码里传给send的密码长度，打印username.length()和password.length()，确认没有因为\0截断。另外AUTH LOGIN要求发 base64 后的值，如果直接发了明文用户名，服务器也会回 535。

5.4 中继被拒：550 不一定是账号问题

现象：认证成功、MAIL FROM也返回 250，但RCPT TO或DATA后返回550 relay denied。原因是 SMTP 服务器做了中继白名单，客户端 IP 没有被允许通过服务器转发。这跟账号密码没关系，换一百个密码都一样。

解决：在企业自建邮件服务器上，把客户端所在网段加入中继白名单；或者确认发件人地址和登录账号一致——很多服务器要求MAIL FROM必须是登录账号的地址，不能随手写一个admin@xxx。处理办法是把from参数固定为登录邮箱本身，不让业务代码自由传值。

5.5 中文乱码：“温度告警”变成一连串问号

现象：收到的邮件标题是??或乱码，正文中文全部变成问号。原因是标题没有按 MIME 编码，服务器直接按 ASCII 处理非 ASCII 字符，超出字节范围的部分变成了不可识别字符。正文如果没声明字符集，客户端会用本地编码猜，跨平台必乱。

解决：标题统一用=?UTF-8?B?+ base64 +?=的格式；正文在DATA头部加Content-Type: text/plain; charset="utf-8"，正文内容转换成 UTF-8 编码后再发送。如果邮件是发给 Windows 老客户端的，可以把 charset 改成gb2312，但要保证代码里实际发送的字节确实是 GBK，别只改了声明不改内容。这块是典型玄学重灾区，建议写一个编码函数，只改这一个入口。

6. 验证邮件真的发出去了：日志、返回码序列与抓包确认

6.1 把 SMTP 会话写进日志

跑通一次代表不了什么，真正上线后必须在日志里留下完整的会话记录。我的做法是在MailSender里加一个日志开关，把每一行SendLine的命令和ReadLine的响应都追加到smtp_yyyyMMdd.log。如果不想引第三方库，直接用fopen追加写入即可；项目里已经在用 spdlog 的话，用它记这些会话信息更顺手。日志里只记命令名，不记密码原文。

FILE* log = fopen("smtp.log", "a"); fprintf(log, "C: %s\n", line.c_str()); // 记录发送的命令 fprintf(log, "S: %s\n", reply.c_str()); // 记录服务器响应 fclose(log);

6.2 用返回码序列和抓包确认最终状态

代码里设置一个状态机，明确规定成功序列是220 → 250 → 334 → 334 → 235 → 250 → 250 → 354 → 250 → 221，任意一步偏离就把响应码和前后文一起写日志。这一步比看程序退出码可靠得多，因为很多失败的邮件会被服务器延迟退信，程序当时并不知道。

上线前再做一次抓包验证。用 Wireshark 过滤tcp.port == 587，追踪 TCP 流，确认认证阶段的内容是加密的；如果在明文流里看到了AUTH LOGIN和类似 base64 的字符串，说明 STARTTLS 没有真正生效，要回去查SSL_connect的返回值。我自己的习惯是每次改完 TLS 相关代码，都会先往自己邮箱发一封测试邮件，然后抓包看一遍握手，再顺手清空收件箱重新验证一次。这个习惯帮我挡过不少自以为没问题的问题，希望帮到你。

本文还有配套的精品资源，点击获取