C语言连接MySQL实战指南（MySQL C API入门与详解）

一、准备工作：安装 MySQL C 客户端库

在开始编码前，你需要确保系统中已安装 MySQL 的 C 开发库。不同操作系统安装方式如下：

Ubuntu/Debian：

sudo apt-get install libmysqlclient-dev

CentOS/RHEL：

sudo yum install mysql-devel

macOS（使用 Homebrew）：

brew install mysql-clientexport PATH="/opt/homebrew/bin:$PATH"

二、编写第一个 C 程序连接 MySQL

下面是一个完整的示例程序，演示如何使用 MySQL C API 连接数据库、执行查询并输出结果。这也是 C语言数据库编程 的基础模板。

#include <stdio.h>#include <stdlib.h>#include <mysql/mysql.h>int main() {    MYSQL *conn;    MYSQL_RES *res;    MYSQL_ROW row;    // 初始化 MySQL 连接句柄    conn = mysql_init(NULL);    if (conn == NULL) {        fprintf(stderr, "mysql_init() failed\n");        exit(1);    }    // 连接到 MySQL 服务器    if (mysql_real_connect(conn, "localhost", "your_username", "your_password",                           "your_database", 0, NULL, 0) == NULL) {        fprintf(stderr, "Connection failed: %s\n", mysql_error(conn));        mysql_close(conn);        exit(1);    }    printf("Connected to MySQL database successfully!\n");    // 执行 SQL 查询    if (mysql_query(conn, "SELECT id, name FROM users")) {        fprintf(stderr, "Query failed: %s\n", mysql_error(conn));        mysql_close(conn);        exit(1);    }    // 获取查询结果    res = mysql_store_result(conn);    if (res == NULL) {        fprintf(stderr, "Store result failed: %s\n", mysql_error(conn));        mysql_close(conn);        exit(1);    }    // 遍历结果集    while ((row = mysql_fetch_row(res)) != NULL) {        printf("ID: %s, Name: %s\n", row[0], row[1]);    }    // 释放结果集和连接资源    mysql_free_result(res);    mysql_close(conn);    return 0;}

三、编译与运行程序

将上述代码保存为 mysql_test.c，然后使用以下命令编译（注意链接 MySQL 客户端库）：

gcc -o mysql_test mysql_test.c `mysql_config --cflags --libs`

运行程序：

./mysql_test

四、关键函数说明

• mysql_init()：初始化连接结构体。
• mysql_real_connect()：建立到 MySQL 服务器的实际连接。
• mysql_query()：执行 SQL 语句（如 SELECT、INSERT、UPDATE）。
• mysql_store_result()：获取 SELECT 查询的结果集。
• mysql_fetch_row()：逐行读取结果。
• mysql_free_result() 和 mysql_close()：释放资源，防止内存泄漏。

五、安全与错误处理建议

在实际的 MySQL客户端开发 中，请务必注意以下几点：

• 永远不要在代码中硬编码数据库密码，建议使用配置文件或环境变量。
• 每次调用 MySQL 函数后检查返回值，及时处理错误。
• 使用参数化查询（通过 mysql_stmt_prepare）防止 SQL 注入。
• 确保在程序退出前释放所有分配的资源。

六、总结

通过本教程，你已经掌握了使用 C语言连接MySQL 的基本方法，并了解了 MySQL C API教程 的核心流程。无论是进行 C语言数据库编程 还是开发高性能的 MySQL客户端开发 应用，这些知识都是坚实的基础。下一步可以尝试实现插入、更新、事务处理等更复杂的功能。

祝你在 C 与 MySQL 的世界中编码愉快！