C语言连接MySQL（从零开始掌握MySQL C API数据库编程）

一、准备工作

要使用C语言操作MySQL，你需要安装以下两个关键组件：

• MySQL Server：数据库服务端（用于存储和管理数据）
• MySQL C Connector（即 libmysqlclient）：C语言客户端库，提供API供C程序调用

在Ubuntu/Debian系统中，你可以通过以下命令安装：

sudo apt updatesudo apt install mysql-server libmysqlclient-dev  

在CentOS/RHEL系统中：

sudo yum install mysql-server mysql-devel  

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

下面是一个完整的示例程序，展示如何连接MySQL、执行查询并关闭连接。这个例子体现了典型的MySQL C API使用流程。

#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);    }    // 连接数据库    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("成功连接到MySQL数据库！\n");    // 执行SQL查询    if (mysql_query(conn, "SELECT VERSION()")) {        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("MySQL版本: %s\n", row[0]);    }    // 释放结果集并关闭连接    mysql_free_result(res);    mysql_close(conn);    return 0;}  

三、编译与运行

保存上述代码为 connect_mysql.c，然后使用以下命令编译：

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

注意：反引号中的 mysql_config --cflags --libs 会自动包含头文件路径和链接库，这是使用C语言数据库编程的标准做法。

运行程序：

./connect_mysql  

如果看到输出“成功连接到MySQL数据库！”以及MySQL版本号，恭喜你，已经成功完成了第一次MySQL客户端开发！

四、常见问题与注意事项

• 确保MySQL服务正在运行：可通过 systemctl status mysql 检查
• 用户名、密码和数据库名必须正确，建议先用命令行工具测试连接
• 每次使用完结果集后务必调用 mysql_free_result() 防止内存泄漏
• 所有MySQL API函数都可能失败，务必检查返回值并处理错误

五、总结

通过本教程，你已经掌握了使用C语言连接MySQL的基本方法。无论是进行C语言连接MySQL的项目开发，还是深入学习MySQL C API，这都是坚实的第一步。后续你可以尝试插入数据、事务处理、预处理语句等高级功能，进一步提升你的C语言数据库编程能力。

坚持练习，你很快就能成为熟练的MySQL客户端开发工程师！