c++怎么连接MySQL数据库_c++ MySQL Connector/C++使用教程【数据库】

推荐使用 MySQL 官方 Connector/C++ 连接数据库,它基于 JDBC 风格 API,支持面向对象操作、预处理语句、事务及 SSL,兼容 MySQL 5.7/8.0+;需安装对应开发包,正确配置路径,捕获 sql::SQLException 异常,并设置 utf8mb4 字符集防乱码。

要用 C++ 连接 MySQL 数据库,推荐使用官方提供的 MySQL Connector/C++(不是旧版的 Connector/C),它基于 JDBC 风格 API,支持面向对象操作,兼容 MySQL 5.7/8.0+,且支持预处理语句、事务、SSL 等特性。

一、环境准备与依赖安装

确保已安装:

  • MySQL 服务器(本地或远程,确认可访问)
  • CMake(用于编译示例或自定义构建)
  • MySQL Connector/C++ 开发包(推荐从 MySQL 官网下载)

Linux(Ubuntu/Debian)可直接用 apt:

sudo apt update && sudo apt install libmysqlcppconn-dev

macOS(Homebrew):

brew install mysql-connector-c++

Windows 建议下载 ZIP 包,解压后将 libinclude 路径加入项目配置(VS 中设置附加包含目录和附加库目录)。

二、基础连接与查询示例

以下是最简可用代码(需链接 mysqlcppconn 库):

#include 
#include 
#include 
#include 
#include 

int main() { sql::Driver* driver = get_driver_instance(); std::unique_ptr conn( driver->connect("tcp://127.0.0.1:3306", "root", "your_password") ); conn->setSchema("testdb");

std::unique_ptrzuojiankuohaophpcnsql::Statementyoujiankuohaophpcn stmt(conn-youjiankuohaophpcncreateStatement());
std::unique_ptrzuojiankuohaophpcnsql::ResultSetyoujiankuohaophpcn res(stmt-youjiankuohaophpcnexecuteQuery("SELECT id, name FROM users"));

while (res-youjiankuohaophpcnnext()) {
    std::cout zuojiankuohaophpcnzuojiankuohaophpcn "ID: " zuojiankuohaophpcnzuojiankuohaophpcn res-youjiankuohaophpcngetInt("id")
              zuojiankuohaophpcnzuojiankuohaophpcn ", Name: " zuojiankuohaophpcnzuojiankuohaophpcn res-youjiankuohaophpcngetString("name") zuojiankuohaophpcnzuojiankuohaophpcn "\n";
}
return 0;

}

编译命令(Linux/macOS 示例):

g++ -o demo demo.cpp -lmysqlcppconn

三、关键注意事项

  • 连接字符串格式灵活:支持 tcp://unix://(本地 socket)、ssl://;也可写成 URL 形式:"mysqlx://user:pass@host:port/db"(仅限 X DevAPI,非本文 Connector/C++)
  • 异常必须捕获:所有 API 可能抛出 sql::SQLException,建议用 try/catch 包裹关键操作
  • 资源自动管理推荐:用 std::unique_ptrstd::shared_ptr 管理 Connection/Statement/ResultSet,避免内存泄漏
  • 中文乱码?:连接后立即执行 conn->setAutoCommit(false); conn->execute("SET NAMES utf8mb4");

四、插入与参数化查询(防 SQL 注入)

使用 PreparedStatement 替代拼接字符串:

std::unique_ptr pstmt(
    conn->prepareStatement("INSERT INTO users(name, age) VALUES (?, ?)")
);
pstmt->setString(1, "张三");
pstmt->setInt(2, 25);
pstmt->executeUpdate(); // 返回影响行数

注意:占位符是 ?,索引从 1 开始;类型方法如 setStringsetDoublesetNull 等需严格匹配字段类型。

基本上就这些。不复杂但容易忽略异常处理和字符集设置,跑通第一步后,再逐步加事务、连接池(需自行封装或集成第三方如 cpptangoodb)也不难。