GBK转UTF-8前需确认系统环境：Windows默认支持GBK（CP936），Linux/macOS需安装libiconv且locale设为zh_CN.GB18030等兼容编码；跨平台推荐libiconv而非已弃用的std::codecvt_utf8，调用iconv_open("UTF-8", "GBK")并预检非法字节或使用"UTF-8//IGNORE"容错。
GBK字符串转UTF8前，先确认系统环境是否支持GBK
Windows默认使用GBK（CP936）作为本地编码，Linux/macOS则通常用UTF8。如果在Linux上处理GBK文本，iconv或libiconv必须已安装，且系统locale不包含GBK支持（如zh_CN.GB18030可兼容GBK，但C或en_US.UTF-8不行）。直接调std::codecvt_utf8（已弃用）或std::wstring_convert会静默失败或抛std::range_error。
- 检查当前locale：运行
locale命令，确认LC_CTYPE含GB18030或GBK - 临时切换（仅测试）：
export LC_CTYPE=zh_CN.GB18030 - 跨平台项目建议统一用
libiconv，不依赖系统locale
用libiconv做转换最稳，别碰std::codecvt
std::codecvt_utf8在C++17被标记为deprecated，GCC 11+、Clang 14+编译会警告，MSVC虽暂保留但行为不可靠——尤其对GBK中“区位码超出0xA1–0xFE范围”的字符（如部分生僻字、旧版扩展字符）会截断或乱码。libiconv是事实标准，支持GB2312/GBK/GB18030全系列，且可控制错误处理策略。
- 安装：Ubuntu/Debian执行
sudo apt install libiconv-dev；macOS用brew install libiconv - 链接时加
-liconv（注意顺序：源文件后，-liconv放最后） - 关键参数：
iconv_open("UTF-8", "GBK")——第二个参数写"GBK"或"CP936"都行，但别写"GB2312"（不兼容GBK扩展字）
// 示例：GBK char* → UTF8 std::string
#include <iconv.h>
#include <vector>
#include <string>
<p>std::string gbk_to_utf8(const char* gbk_str) {
iconv_t cd = iconv_open("UTF-8", "GBK");
if (cd == (iconv_t)(-1)) return {};</p><pre class="brush:php;toolbar:false;">size_t in_left = strlen(gbk_str);
size_t out_left = in_left * 3; // UTF8最长3字节/字符
std::vector<char> out_buf(out_left);
char* in_ptr = const_cast<char*>(gbk_str);
char* out_ptr = out_buf.data();
size_t res = iconv(cd, &in_ptr, &in_left, &out_ptr, &out_left);
iconv_close(cd);
if (res == (size_t)(-1)) return {}; // 转换失败，如非法GBK序列
return std::string(out_buf.data(), out_buf.size() - out_left);}
遇到“Invalid or incomplete multibyte or wide character”错误怎么办
这是iconv返回(size_t)(-1)时的典型errno（EILSEQ），说明输入中有非法GBK字节序列（比如单个0x81、末尾截断的双字节）。默认行为是停止转换，但你可以让iconv跳过坏字节：
- 创建cd时用
iconv_open("UTF-8//IGNORE", "GBK")——//IGNORE后缀让其跳过非法序列 - 或用
//TRANSLIT尝试音近替换（如“?”→“吉”，但GBK本身不含此字，实际效果有限） - 更安全的做法：先用
is_gbk_valid()预检（检查每两个字节是否落在GBK有效范围：首字节0x81–0xFE，次字节0x40–0x7E或0x80–0xFE），再进iconv
Windows下用MultiByteToWideChar + WideCharToMultiByte更轻量
若只跑Windows，不用引第三方库。MultiByteToWideChar(CP_ACP, ...)在中文系统等于GBK，但注意：CP_ACP随系统区域设置变，硬编码CP936更可靠。两步转换（GBK → UTF16 → UTF8）比libiconv略慢，但无依赖、API稳定。
立即学习“C++免费学习笔记（深入）”；
- 第一步：用
MultiByteToWideChar(936, 0, gbk_str, -1, nullptr, 0)得UTF16长度（含结尾\0） - 第二步：分配
wchar_t*，再调一次填入；然后用WideCharToMultiByte(CP_UTF8, ...)转出 - 别忘了
WideCharToMultiByte返回的是字节数，不是字符数——UTF8里一个汉字是3字节
GB18030兼容性比纯GBK高（支持四字节扩展汉字），如果数据来源不可控，优先用"GB18030"代替"GBK"，多数libiconv版本都支持，Windows也认CP54936。
