当前位置：首页 > 问答 > 正文

C语言里头到底怎么搞定数据库连接这事儿，步骤和注意点分享

太叔访天
问答
2026-01-23 09:44:02
2

行，那咱们就直接开聊C语言里头怎么搞定数据库连接这事儿，说白了，就是用C这个比较底层的语言，去和数据库（比如MySQL、SQLite这些）搭上话，能让你的程序存数据、取数据。

这事儿不像用Java或者Python，它们有现成又好用的框架，比如JDBC、SQLAlchemy，几乎把脏活累活都包了，C语言里你得自己多动手，但核心思路都差不多：找对库、连上线、发命令、拿结果、关连接，下面我主要拿最常用的MySQL和最简单的SQLite来当例子,把步骤和容易栽跟头的地方捋一捋。

第一步：选对并准备好数据库客户端库

C语言本身可没有自带连接数据库的功能，你必须借助第三方库，这就好比你想拧螺丝,得先去找把合适的螺丝刀。

MySQL：最常用的是MySQL官方提供的 libmysqlclient，你需要先去MySQL官网把这个开发包下载下来并安装好，在Linux上，可能用包管理器直接装就行，sudo apt-get install libmysqlclient-dev，装好后，你的编译器需要知道这个库的头文件在哪（#include <mysql/mysql.h>），链接的时候也要告诉它库文件在哪（比如编译时加 -lmysqlclient）。
SQLite：这个就简单多了，因为它本身就是一个轻量级的、整个数据库就是一个文件的数据库，你只需要去SQLite官网下一个 sqlite3.c 和 sqlite3.h，直接把它俩扔到你的项目里一起编译就行，或者也可以安装开发包，链接 -lsqlite3。

注意点1：环境配置是第一个坎。 很多新手就倒在这一步，如果你用的是IDE（比如Code::Blocks, Visual Studio），一定要在项目属性里把“头文件包含路径”和“库文件链接路径”指对地方，命令行编译的话，-I 参数指定头文件路径，-L 指定库路径，-l 指定库名字，弄错了编译器就会嚷嚷“找不到头文件”或者“未定义的引用”。

第二步：建立连接

库准备好了,接下来就是写代码建立连接。

对于MySQL,这个过程稍微复杂点：
1. 初始化一个 MYSQL 结构体指针，这可以看作是连接对象的句柄。MYSQL *conn = mysql_init(NULL);
2. 用 mysql_real_connect 函数，传入这个句柄、数据库服务器的地址（localhost就是本机）、用户名、密码、要用的数据库名、端口号（默认3306）等参数，这个函数会尝试真正地连接到数据库服务器。 conn = mysql_real_connect(conn, "localhost", "你的用户名", "你的密码", "要用的数据库名", 0, NULL, 0);
3. 一定要检查这个函数的返回值，如果返回 NULL，说明连接失败了，可以用 mysql_error(conn) 看看具体错在哪，可能是密码错了、数据库不存在、或者服务器根本没启动。
对于SQLite,就非常直接：
1. 定义一个 sqlite3 * 的指针。
2. 用 sqlite3_open("数据库文件路径", &你的指针) 这个函数，如果那个文件不存在,SQLite会自动创建一个。
3. 同样，检查返回值是不是 SQLITE_OK,如果不是就是出错了。
注意点2：密码和敏感信息别写死在代码里！ 这是安全问题，尤其是在MySQL连接时，直接把密码像 "123456" 这样写在代码里是非常危险的，万一代码泄露了，数据库就任人宰割了，稍微好点的做法是从配置文件、环境变量或者启动参数里读取。
注意点3：连接失败是常态，一定要处理。 网络不通、数据库服务挂了、密码错误……情况很多，你的程序不能假设连接一定能成功，必须有错误处理逻辑，给用户一个友好的提示,然后优雅地退出或重试。

第三步：执行SQL语句

连接成功后,你就可以发号施令了。

执行不返回数据的语句：比如建表、插入数据、删除数据、更新数据，这类用 CREATE, INSERT, UPDATE, DELETE 等开头的SQL。
- MySQL：用 mysql_query(conn, "你的SQL语句")。mysql_query(conn, "INSERT INTO users VALUES('张三', 20)"),成功后返回0。
- SQLite：用 sqlite3_exec(你的指针, "你的SQL语句", NULL, NULL, NULL)，更灵活的方式是先用 sqlite3_prepare_v2 准备语句,后面会提到。
执行会返回数据的查询语句：主要是 SELECT 查询。
- MySQL：还是先用 mysql_query 执行SELECT语句，如果成功，你需要用 mysql_store_result(conn) 把结果集取回来，得到一个 MYSQL_RES 结构体，然后就像读表格一样，用 mysql_fetch_row(这个结果集) 一行一行地读，每一行是一个字段值数组（char **），读完返回NULL，读完记得用 mysql_free_result 释放结果集内存。
- SQLite：推荐使用“预处理语句”（prepared statement），这是非常重要的一个概念，能提高效率、防止SQL注入攻击，步骤是： a. 用 sqlite3_prepare_v2(指针, "SELECT * FROM users WHERE age > ?", -1, &stmt, NULL) 准备SQL，这里的是占位符。 b. 用 sqlite3_bind_int(stmt, 1, 18) 这样的函数把值（比如18）绑定到占位符（第1个问号）上。 c. 用 sqlite3_step(stmt) 来执行，如果返回 SQLITE_ROW，表示有一行数据，就用 sqlite3_column_xxx(stmt, 列索引) 来取这一行里每一列的值（xxx是类型，如text, int）。 d. 循环执行 sqlite3_step 直到返回 SQLITE_DONE。 e. 最后用 sqlite3_finalize(stmt) 释放预处理语句。

注意点4：严防SQL注入！ 这是最高频的安全漏洞。绝对不要用字符串拼接的方式构造SQL语句，sprintf(sql, "SELECT * FROM users WHERE name='%s'", user_input)，如果用户输入里带个单引号再跟一段SQL，你的数据库就可能被黑。必须使用上面SQLite例子里的预处理语句（参数化查询），MySQL也有对应的 mysql_stmt_init 系列函数来做预处理,这是铁律！

第四步：处理结果和关闭连接

处理结果：从数据库取回来的数据都是二进制的或者字符串，你需要根据你数据库里字段的定义，转换成C语言里对应的 int, float, char array 等类型。
关闭连接，释放资源：这点在C语言里尤其重要，因为你需要手动管理内存。
- MySQL：最后一定要 mysql_close(conn) 来关闭连接。
- SQLite：最后一定要 sqlite3_close(你的指针)。如果不关闭，可能会造成数据库连接泄露（对于MySQL这种服务端数据库），或者文件锁没释放（对于SQLite）,下次访问就可能出问题。