C++ 实现 UTF-8 与 GBK 字符编码转换及源码示例

实现思路

整体设计思路

1. 使用 iconv_open 创建转换描述符
2. 将输入字符串作为字节流传入
3. 转换后写入输出缓冲区
4. 返回 C++ std::string

关键实现要点

• 输入输出缓冲区必须是 char*
• 输出缓冲区要足够大
• iconv 会修改指针地址
• 转换完成后需释放资源

封装设计

• 提供一个通用转换函数
• 再封装：
  • utf8ToGbk
  • gbkToUtf8

完整实现代码

/****************************************************
 * 文件名：CharsetConvert.cpp
 * 描述：C++ UTF-8 / GBK 编码转换工具
 ****************************************************/
#include <iostream>
#include <string>
#include <iconv.h>
#include <cstring>
using namespace std;

/****************************************************
 * 函数名：convertEncoding
 * 描述：通用字符编码转换函数
 * 参数：
 *   fromCharset - 原编码
 *   toCharset - 目标编码
 *   input - 输入字符串
 * 返回值：
 *   转换后的字符串
 ****************************************************/
string convertEncoding(const string& input, const string& fromCharset, const string& toCharset) {
    // 创建 iconv 转换描述符
    iconv_t cd = iconv_open(toCharset.c_str(), fromCharset.c_str());
    if (cd == (iconv_t)-1) {
        perror("iconv_open");
        return "";
    }

    // 准备输入缓冲区
    size_t inLen = input.size();
    char* inBuf = const_cast<char*>(input.c_str());

    // 输出缓冲区大小一般设置为输入的 2~4 倍
    size_t outLen = inLen * 4;
    char* outBuf = new char[outLen];
    memset(outBuf, 0, outLen);
    char* outPtr = outBuf;

    // 执行转换
    if (iconv(cd, &inBuf, &inLen, &outPtr, &outLen) == (size_t)-1) {
        perror("iconv");
        iconv_close(cd);
        delete[] outBuf;
        return "";
    }

    // 构造返回字符串
    string result(outBuf);

    // 释放资源
    iconv_close(cd);
    delete[] outBuf;
    return result;
}

/****************************************************
 * UTF-8 转 GBK
 ****************************************************/
string utf8ToGbk(const string& utf8Str) {
    return convertEncoding(utf8Str, "UTF-8", "GBK");
}

/****************************************************
 * GBK 转 UTF-8
 ****************************************************/
string gbkToUtf8(const string& gbkStr) {
    return convertEncoding(gbkStr, "GBK", "UTF-8");
}

/****************************************************
 * 主函数：测试编码转换
 ****************************************************/
int main() {
    // UTF-8 中文字符串（Linux 默认）
    string utf8Str = "你好，世界";

    // UTF-8 -> GBK
    string gbkStr = utf8ToGbk(utf8Str);
    cout << "UTF-8 转 GBK 完成" << endl;

    // GBK -> UTF-8
    string utf8Result = gbkToUtf8(gbkStr);
    cout << "GBK 转 UTF-8 结果：" << utf8Result << endl;

    return 0;
}

代码解读

• convertEncoding：通用字符编码转换函数，封装 iconv
• utf8ToGbk：UTF-8 编码字符串转 GBK
• gbkToUtf8：GBK 编码字符串转 UTF-8
• iconv_open：创建编码转换器
• iconv：执行实际转换
• iconv_close：释放转换器资源

总结

通过本项目，你可以系统掌握：

• 字符编码的本质
• UTF-8 与 GBK 的差异
• Linux 下字符编码转换的标准做法
• iconv API 的正确使用方式
• C++ 对 C 库的封装技巧

这是后续学习网络协议解析、HTTP / JSON 处理、跨平台系统开发、国际化（i18n）的必备基础能力。

常见问题

Q1：为什么输出缓冲区要放大？
A：UTF-8 到 GBK / Unicode 转换可能增加字节数。

Q2：Windows 可以用吗？
A：Windows 没有原生 iconv，需要 libiconv 或 WideChar API。

Q3：iconv 会修改指针吗？
A：会，必须使用临时指针变量。

扩展方向

1. 封装为字符编码工具类
2. 支持更多编码（UTF-16、BIG5）
3. 处理文件级编码转换
4. 网络流实时转换
5. Windows / Linux 双平台实现