C语言连接MySQL数据库:详细步骤与代码示例
在C语言中连接MySQL数据库,主要通过MySQL官方提供的C API(libmysqlclient库)来实现。核心步骤包括:初始化连接对象、设置连接参数、建立实际连接以及执行SQL语句,下面将详细说明这一过程,并提供一个基础代码示例。

确保系统已安装MySQL开发库,在Ubuntu/Debian上可使用sudo apt-get install libmysqlclient-dev安装,CentOS则使用sudo yum install mysql-devel,接着在C代码中包含头文件#include <mysql/mysql.h>,并在编译时链接库-lmysqlclient。
连接MySQL的关键步骤如下:
- 初始化连接句柄:使用
mysql_init()函数初始化一个MYSQL结构体,该结构体将用于管理连接。 - 设置连接参数:可通过
mysql_options()配置选项(如字符集),但此步非必需。 - 建立实际连接:调用
mysql_real_connect()函数,传入数据库地址、用户名、密码、数据库名等参数。这是连接成败的关键环节,必须检查返回值以确认连接是否成功。 - 执行SQL操作:连接成功后,使用
mysql_query()执行SQL语句(如查询、插入等),并通过结果集函数处理返回数据。 - 关闭连接:最后使用
mysql_close()释放连接资源,避免内存泄漏。
以下是一个简单的连接示例:
#include <mysql/mysql.h>
#include <stdio.h>
int main() {
MYSQL *conn;
conn = mysql_init(NULL);
if (conn == NULL) {
fprintf(stderr, "初始化失败\n");
return 1;
}
// 连接数据库,参数依次为:连接句柄、主机名、用户名、密码、数据库名、端口、Unix套接字、客户端标志
if (mysql_real_connect(conn, "localhost", "用户名", "密码", "数据库名", 0, NULL, 0) == NULL) {
fprintf(stderr, "连接失败: %s\n", mysql_error(conn));
mysql_close(conn);
return 1;
}
printf("连接成功!\n");
// 此处可执行SQL操作...
mysql_close(conn);
return 0;
}
注意事项:
- 务必进行错误检查:每个API调用后都应检查返回值,利用
mysql_error()获取详细错误信息。 - 字符集设置:若处理中文,建议在连接后执行
mysql_set_character_set(conn, "utf8")避免乱码。 - 资源释放:所有操作结束后必须调用
mysql_close(),长时间运行的程序还需定期检查连接状态。
通过以上步骤,C语言程序即可高效、稳定地与MySQL数据库交互,为底层系统开发或性能敏感型应用提供数据支持。
未经允许不得转载! 作者:HTML前端知识网,转载或复制请以超链接形式并注明出处HTML前端知识网。
原文地址:https://www.html4.cn/5796.html发布于:2026-07-20





