C语言连接PostgreSQL数据库完全指南（从零开始使用libpq库进行PostgreSQL开发）

准备工作：安装依赖

在开始编码前，请确保你的系统已安装以下组件：

• PostgreSQL 服务器（可选，但建议本地测试）
• PostgreSQL 开发包（包含 libpq 头文件和库）

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

sudo apt-get install postgresql postgresql-contrib libpq-dev

在 CentOS/RHEL 中使用：

sudo yum install postgresql-devel

第一个 C 程序：连接 PostgreSQL

下面是一个最简单的 C 程序，演示如何使用 libpq 连接到 PostgreSQL 数据库并打印连接状态。

#include <stdio.h>#include <libpq-fe.h>int main() {    const char *conninfo = "host=localhost dbname=testdb user=postgres password=yourpassword";    PGconn *conn = PQconnectdb(conninfo);    if (PQstatus(conn) != CONNECTION_OK) {        fprintf(stderr, "Connection to database failed: %s", PQerrorMessage(conn));        PQfinish(conn);        return 1;    }    printf("Successfully connected to PostgreSQL!\n");    PQfinish(conn);    return 0;}

这段代码展示了 PostgreSQL C API 的基本用法：

• PQconnectdb()：建立数据库连接
• PQstatus()：检查连接状态
• PQerrorMessage()：获取错误信息
• PQfinish()：关闭连接

编译与运行

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

gcc -o connect connect.c -lpq

其中 -lpq 表示链接 libpq 库。运行程序：

./connect

如果看到 “Successfully connected to PostgreSQL!”，说明你已经成功实现了 libpq库教程 中的第一步！

执行查询并获取结果

连接成功后，我们可以执行 SQL 查询。以下代码演示如何查询一张名为 users 的表：

PGresult *res = PQexec(conn, "SELECT id, name FROM users;");if (PQresultStatus(res) != PGRES_TUPLES_OK) {    fprintf(stderr, "Query failed: %s", PQerrorMessage(conn));    PQclear(res);    PQfinish(conn);    return 1;}int rows = PQntuples(res);int cols = PQnfields(res);for (int i = 0; i < rows; i++) {    printf("ID: %s, Name: %s\n",           PQgetvalue(res, i, 0),           PQgetvalue(res, i, 1));}PQclear(res);

注意：PQgetvalue() 返回的是字符串指针，即使字段是整数类型。如需转换，请使用 atoi() 或 strtol()。

安全提示：防止 SQL 注入

在实际项目中，切勿直接拼接用户输入到 SQL 字符串中！应使用参数化查询（通过 PQexecParams）来避免 SQL 注入攻击。

总结

通过本教程，你已经掌握了使用 C 语言和 libpq 库连接 PostgreSQL 的基本方法。无论是构建高性能后端服务，还是嵌入式数据库应用，C语言 PostgreSQL开发 都是一个值得深入学习的方向。希望这篇 libpq库教程 能为你打下坚实基础！

继续探索 PostgreSQL C API 的更多功能，如异步查询、事务控制、大对象处理等，你将能构建更强大的数据库应用程序。