C++制作邮件发送小工具基础教程

P粉602998670

发布时间：2025-09-13 08:25:01

233人浏览过

来源于php中文网

原创

答案是使用libcurl库可快速实现C++邮件发送功能。通过配置SMTP服务器信息、构建符合MIME标准的邮件内容，并利用libcurl封装的网络通信与SSL/TLS加密，可安全地发送邮件；建议新手优先选择libcurl而非Boost.Asio，因其抽象层级更高、易于上手；凭证应通过环境变量或配置文件管理，避免硬编码；发送带附件的多部分邮件时，推荐使用curl_mime接口自动处理MIME结构与Base64编码，提升开发效率与安全性。

c++制作邮件发送小工具基础教程

制作一个C++邮件发送小工具，核心在于理解SMTP协议，利用第三方库来处理网络通信和邮件格式封装，并妥善管理凭证与错误处理。这并非一件遥不可及的事，即使是基础知识，也能让你搭建起一个功能雏形。

制作C++邮件发送小工具，说白了就是让你的程序能“说话”——通过邮件服务器把消息传递出去。这背后的技术栈，主要围绕着SMTP（Simple Mail Transfer Protocol）协议展开。我个人觉得，当你第一次尝试用代码发送邮件成功时，那种感觉就像是打开了一扇新的大门，原来程序也能和外界进行如此直接的交互。

整个流程大致是这样的：

选择合适的库：C++本身没有内置的邮件发送功能，所以我们得借助外部力量。常用的有
```
libcurl
```
（一个非常强大的客户端URL传输库，支持SMTP）或者
```
Boost.Asio
```
（更底层，可以自己实现SMTP协议）。对于初学者，我通常会推荐
```
libcurl
```
，因为它封装了很多细节，上手更快。
配置SMTP服务器信息：你需要知道目标邮件服务器的地址（比如
```
smtp.gmail.com
```
或
```
smtp.qq.com
```
）、端口号（通常是587或465），以及你的邮箱账号和密码。
构建邮件内容：这包括发件人、收件人、主题、邮件正文，以及可能的附件。邮件内容需要遵循MIME（Multipurpose Internet Mail Extensions）标准进行格式化，这样才能被各种邮件客户端正确解析。
建立连接与认证：程序需要与SMTP服务器建立安全的连接（通常是TLS/SSL加密），然后用你的账号密码进行身份验证。
发送邮件：通过SMTP命令（如
```
MAIL FROM
```
、
```
RCPT TO
```
、
```
DATA
```
）将构建好的邮件内容发送给服务器。
处理响应与错误：服务器会返回一系列状态码，我们需要根据这些状态码判断邮件是否发送成功，或者哪里出了问题。

这里我以

libcurl

为例，它能大大简化SMTP的实现。你需要包含

curl/curl.h

头文件，初始化

CURL

对象，设置各种选项（如URL、用户名、密码、邮件头、邮件体），然后执行发送操作。这个过程虽然看起来步骤多，但

libcurl

已经把最复杂的网络通信和协议细节隐藏起来了，你只需要关注“要发送什么”和“发送到哪里”。

立即学习“C++免费学习笔记（深入）”；

#include <iostream>
#include <string>
#include <vector>
#include <curl/curl.h> // 确保你已经安装了libcurl库

// 这是一个简单的回调函数，用于libcurl读取邮件体
size_t payload_source(void *ptr, size_t size, size_t nmemb, void *userp) {
    std::string *payload = static_cast<std::string*>(userp);
    if (size == 0 || nmemb == 0 || payload->empty()) {
        return 0;
    }

    size_t copy_len = std::min(payload->length(), size * nmemb);
    memcpy(ptr, payload->c_str(), copy_len);
    payload->erase(0, copy_len); // 模拟读取后移除已发送部分
    return copy_len;
}

int main() {
    CURL *curl;
    CURLcode res = CURLE_OK;

    // 邮件内容
    std::string from = "your_email@example.com";
    std::string to = "recipient_email@example.com";
    std::string subject = "C++邮件发送测试";
    std::string body = "Hello from C++ with libcurl!\r\nThis is a test email.";

    // 构建邮件头和正文
    std::string full_payload =
        "From: <" + from + ">\r\n"
        "To: <" + to + ">\r\n"
        "Subject: " + subject + "\r\n"
        "Content-Type: text/plain; charset=\"utf-8\"\r\n"
        "\r\n" + body + "\r\n";

    std::string payload_copy = full_payload; // libcurl会修改，所以用副本

    curl_global_init(CURL_GLOBAL_ALL);
    curl = curl_easy_init();

    if (curl) {
        // SMTP服务器地址和端口
        curl_easy_setopt(curl, CURLOPT_URL, "smtps://smtp.example.com:465"); // 使用SSL/TLS加密
        curl_easy_setopt(curl, CURLOPT_USERNAME, from.c_str());
        curl_easy_setopt(curl, CURLOPT_PASSWORD, "your_email_password"); // ⚠️ 实际应用中不应硬编码密码

        // 设置发件人和收件人
        curl_easy_setopt(curl, CURLOPT_MAIL_FROM, ("<" + from + ">").c_str());
        struct curl_slist *recipients = NULL;
        recipients = curl_slist_append(recipients, ("<" + to + ">").c_str());
        curl_easy_setopt(curl, CURLOPT_MAIL_RCPT, recipients);

        // 设置邮件体读取函数
        curl_easy_setopt(curl, CURLOPT_READFUNCTION, payload_source);
        curl_easy_setopt(curl, CURLOPT_READDATA, &payload_copy);
        curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L); // 告诉libcurl我们正在上传数据

        // 启用SSL/TLS证书验证
        curl_easy_setopt(curl, CURLOPT_USE_SSL, (long)CURLUSESSL_ALL);
        // curl_easy_setopt(curl, CURLOPT_CAINFO, "/path/to/cacert.pem"); // 如果需要指定CA证书

        // 调试信息（可选）
        // curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);

        res = curl_easy_perform(curl);

        if (res != CURLE_OK) {
            std::cerr << "curl_easy_perform() failed: " << curl_easy_strerror(res) << std::endl;
        } else {
            std::cout << "Email sent successfully!" << std::endl;
        }

        curl_slist_free_all(recipients);
        curl_easy_cleanup(curl);
    }

    curl_global_cleanup();
    return 0;
}

注意：上述代码中的

smtp.example.com

和

your_email_password

需要替换为你的实际信息。特别是密码，在实际项目中绝对不能硬编码在代码里，这只是一个演示。

选择合适的C++邮件发送库：libcurl与Boost.Asio哪个更适合新手？

这真是一个经典的问题，就像问“学开车是直接上赛道还是先从驾校开始？”。我的经验是，对于大多数想快速实现邮件发送功能的C++新手来说，

libcurl

无疑是更友好的选择。它是一个高度抽象的网络传输库，把SMTP协议的底层细节封装得很好。你只需要配置好URL、认证信息、邮件头和邮件体，剩下的

libcurl

会帮你搞定。它的API设计更偏向于“我需要发送一个HTTP请求”或“我需要发送一封邮件”这样的高层次任务，大大降低了学习曲线。你会发现，很多时候，你只是在设置一系列的选项，然后调用一个

perform

函数，邮件就发出去了。这对于那些不希望深究网络套接字编程、协议状态机转换的开发者来说，简直是福音。

然而，

Boost.Asio

则完全是另一种风格。它是一个用于网络和低级I/O编程的库，提供的是异步I/O、定时器、套接字等更底层的原语。如果你用

Boost.Asio

来发送邮件，那意味着你需要自己去实现SMTP协议的每一个步骤：建立TCP连接、发送

HELO

、

AUTH LOGIN

、

MAIL FROM

、

RCPT TO

、

DATA

，并解析服务器的每一个响应。这需要你对SMTP协议有相当深入的理解，包括它的状态转换、错误码等等。它提供了极大的灵活性和控制力，比如你可以实现更复杂的错误恢复机制、自定义认证方式，或者构建高性能的异步邮件发送服务。但对于新手，这无疑是一座更高的山，需要投入更多的时间去学习网络编程的基础知识和

Boost.Asio

本身的异步模型。

所以，我的建议是：如果你只是想快速实现一个功能，或者你的项目对性能和底层控制没有极致要求，那么选择

libcurl

。它的文档丰富，社区活跃，遇到问题也更容易找到解决方案。但如果你对网络编程有浓厚兴趣，想深入理解SMTP协议的工作原理，或者你的项目需要高度定制化、异步非阻塞的邮件发送，并且你愿意投入时间去学习，那么

Boost.Asio

会是一个非常有价值的探索方向。它能让你从更底层的角度理解网络通信的精髓。

C++邮件发送中如何安全处理用户凭证与SSL/TLS加密？

安全性，这在任何网络通信中都是重中之重，尤其涉及用户凭证。我见过太多新手直接把邮箱账号和密码硬编码在代码里，然后把代码推到GitHub上，这简直是自掘坟墓。

关于用户凭证（账号和密码）：

绝对不要硬编码： 这是最基本的原则。一旦代码泄露，你的邮箱就可能被盗用。
环境变量： 一个相对简单且有效的做法是将邮箱账号和密码存储在操作系统的环境变量中。程序启动时读取这些变量。这样，凭证就不会出现在源代码里，也方便部署到不同的环境。
配置文件： 可以使用配置文件（如INI、JSON、YAML）来存储凭证。但需要注意的是，配置文件本身也需要保护，不能随意暴露。可以加密配置文件，或者设置严格的文件访问权限。
安全存储： 对于生产环境，更安全的做法是使用密钥管理服务（KMS）或专门的凭证管理系统，程序运行时动态获取凭证。或者，如果是在桌面应用中，可以考虑使用操作系统的密钥链（KeyChain）服务来加密存储。
OAuth 2.0： 很多大型邮件服务商（如Gmail、Outlook）现在都推荐使用OAuth 2.0进行认证，而不是直接使用账号密码。OAuth 2.0允许你的应用在不获取用户密码的情况下，通过用户授权来访问其邮件服务。虽然实现起来更复杂，但安全性更高，是未来邮件应用的方向。

关于SSL/TLS加密： SSL/TLS是确保邮件内容在客户端和SMTP服务器之间传输时不会被窃听或篡改的关键技术。

始终使用加密连接： 大多数现代SMTP服务器都要求使用SSL/TLS加密。通常端口465是隐式SSL/TLS，而端口587则使用STARTTLS（先建立普通连接，然后升级为TLS）。在
```
libcurl
```
中，通过设置
```
CURLOPT_USE_SSL
```
和URL中的
```
smtps://
```
前缀来启用。
证书验证： 这是SSL/TLS的核心。你的程序应该验证服务器的SSL证书是否有效、是否由受信任的CA（Certificate Authority）签发，以防止中间人攻击（Man-in-the-Middle attack）。
```
libcurl
```
默认会进行证书验证，它会查找系统自带的CA证书库。如果你的系统没有正确配置或你需要使用自定义的CA证书，可以通过
```
CURLOPT_CAINFO
```
选项指定CA证书文件的路径。
错误处理： 如果SSL/TLS握手失败或证书验证失败，程序应该能够捕获这些错误并给出明确的提示，而不是继续发送敏感数据。这通常意味着网络问题、服务器配置错误，或者更糟的，可能遭遇了攻击。

我记得有一次，我部署了一个小工具，因为服务器环境没有正确配置CA证书，导致

libcurl

一直报错说无法验证对等证书。当时排查了好久，才发现是证书路径的问题。这让我意识到，即使是基础的证书验证，也需要细心对待，否则安全功能形同虚设。

构建邮件内容：如何用C++实现多部分邮件（MIME）与附件发送？

构建邮件内容，特别是包含附件或富文本（HTML）的邮件，就不得不提到MIME（Multipurpose Internet Mail Extensions）标准。MIME就像是一个“邮件的语言”，它允许邮件客户端发送和接收各种非文本类型的数据，比如图片、音频、视频，当然也包括HTML格式的邮件和文件附件。

CreateWise AI

为播客创作者设计的AI创作工具，AI自动去口癖、提交亮点和生成Show notes、标题等

下载

当你发送一封简单的纯文本邮件时，邮件体直接就是文本内容。但如果想发送带有附件的邮件，或者同时包含纯文本和HTML格式的邮件（这样即使收件人的客户端不支持HTML，也能看到纯文本内容），你就需要用到MIME的“多部分”（

multipart

）特性。

核心概念：边界（Boundary） MIME多部分邮件的关键在于一个叫做“边界字符串”（

boundary

）的东西。这个字符串必须是邮件内容中绝对不会出现的唯一字符串。它用来分隔邮件的不同部分（比如纯文本部分、HTML部分、附件部分）。

实现步骤（以

libcurl

为例）：

设置
```
Content-Type: multipart/mixed
```
或
multipart/alternative
：
- ```
multipart/mixed
```
  : 用于发送包含附件的邮件。每个附件和邮件正文都是一个独立的部分。
- ```
multipart/alternative
```
  : 用于发送同一内容的多种表示形式（如纯文本和HTML）。客户端会选择它能支持的最佳版本来显示。你可以根据需要混合使用这两种类型，例如，
```
multipart/mixed
```
  中包含一个
```
multipart/alternative
```
  作为邮件正文。
生成唯一的边界字符串： 确保它在邮件内容中不会重复。一个常见做法是使用时间戳或UUID。

构建邮件头： 除了

From

、

To

、

Subject

等，你还需要添加一个

Content-Type

头，指定为

multipart/mixed

（或

multipart/alternative

），并带上你的边界字符串。

Content-Type: multipart/mixed; boundary="----=_Part_123456789_abcdefg"

构建邮件体： 邮件体将由多个部分组成，每个部分都以

--

加上边界字符串开始，以

--

加上边界字符串再加

--

结束。

每个部分内部： 每个部分也需要自己的
```
Content-Type
```
头，说明该部分的内容类型（例如
```
text/plain
```
、
```
text/html
```
、
```
image/jpeg
```
、
```
application/pdf
```
等），以及
```
Content-Transfer-Encoding
```
头（通常是
```
base64
```
，特别是对于二进制附件）。

纯文本部分：

------=_Part_123456789_abcdefg
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit

这是邮件的纯文本内容。

HTML部分（如果使用

multipart/alternative

）：

------=_Part_123456789_abcdefg
Content-Type: text/html; charset="utf-8"
Content-Transfer-Encoding: quoted-printable

<html><body><h1>这是邮件的HTML内容！</h1></body></html>

（注意HTML内容可能需要

quoted-printable

编码，或者直接

base64

）

附件部分： 附件通常需要进行Base64编码，因为邮件传输的是文本。

------=_Part_123456789_abcdefg
Content-Type: application/octet-stream; name="attachment.pdf"
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="attachment.pdf"

[这里是attachment.pdf文件内容的Base64编码]

libcurl

在发送附件时，可以使用

CURLOPT_MIMEPOST

选项来构建多部分MIME邮件，这比手动拼接字符串要方便得多。你需要创建

curl_mime

对象，然后添加各个部分。

// 假设你已经有了libcurl的初始化和清理
// ...
    curl_mime *mime;
    curl_mimepart *part;

    mime = curl_mime_init(curl);

    // 1. 添加纯文本邮件体
    part = curl_mime_addpart(mime);
    curl_mime_data(part, "这是邮件的纯文本内容。", CURL_ZERO_TERMINATED);
    curl_mime_type(part, "text/plain");
    curl_mime_encoder(part, "7bit"); // 或 "quoted-printable"

    // 2. 添加HTML邮件体 (如果需要，通常与纯文本一起用于multipart/alternative)
    // part = curl_mime_addpart(mime);
    // curl_mime_data(part, "<html><body><h1>这是HTML内容！</h1></body></html>", CURL_ZERO_TERMINATED);
    // curl_mime_type(part, "text/html");
    // curl_mime_encoder(part, "quoted-printable");

    // 3. 添加附件
    part = curl_mime_addpart(mime);
    curl_mime_filedata(part, "path/to/your/file.pdf"); // 指定文件路径
    curl_mime_type(part, "application/pdf"); // 指定MIME类型
    curl_mime_name(part, "attachment.pdf"); // 指定附件在邮件中显示的文件名
    curl_mime_filename(part, "attachment.pdf"); // 这通常和name一样，但可以不同

    // 设置libcurl使用构建好的MIME数据
    curl_easy_setopt(curl, CURLOPT_MIMEPOST, mime);

    // 设置邮件头，注意这里不再需要手动拼接Content-Type，libcurl会自动生成
    // ... 添加From, To, Subject等其他邮件头
    struct curl_slist *headers = NULL;
    headers = curl_slist_append(headers, ("From: <" + from + ">").c_str());
    headers = curl_slist_append(headers, ("To: <" + to + ">").c_str());
    headers = curl_slist_append(headers, ("Subject: " + subject).c_str());
    curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);

    // ... 其他设置和执行
    res = curl_easy_perform(curl);
    // ... 清理
    curl_mime_free(mime); // 释放mime对象
    curl_slist_free_all(headers);
// ...

通过