GetPrivateProfileString 读不出中文或返回空字符串，因其内部用 CP_ACP（如 GBK）转换，不支持 UTF-8/UTF-16LE 编码的 INI 文件；路径需 ANSI 字符串，缓冲区须初始化且留足空间；WritePrivateProfileString 非原子写入、无锁、易致编码混杂与格式错乱；推荐用 std::wifstream/std::wofstream 或 tiny-ini 替代。
Windows 平台下，GetPrivateProfileString 和 WritePrivateProfileString 能读写 INI 文件，但默认只支持 ANSI 编码、不支持 Unicode 路径、线程不安全——别在新项目里直接用。
为什么 GetPrivateProfileString 读不出中文或返回空字符串
这是最常踩的坑：函数内部用的是 MultiByteToWideChar(CP_ACP, ...)，也就是依赖系统当前 ANSI 代码页（如 GBK）。如果你的 INI 文件是 UTF-8 或 UTF-16LE 保存的，它根本解析不了，直接返回空或乱码。
- 确认文件编码：用记事本另存为时选“ANSI”，不是“UTF-8 无 BOM”
- 路径必须是 ANSI 字符串：
"C:\cfg.ini"可以，L"C:\cfg.ini"会静默失败 -
lpReturnedString缓冲区要留足空间，且必须初始化为 0（否则可能读到脏内存） - 示例中常见错误：
char buf[256]; GetPrivateProfileStringA("sec", "key", "", buf, 256, "cfg.ini");—— 如果 ini 里值含中文，GBK 下一个汉字占 2 字节，buf[256] 实际最多存 127 个汉字，超了就截断
WritePrivateProfileString 写入后文件没更新或格式错乱
这个函数不保证原子写入，也不重排 section/key 顺序，更不会补换行或空格。多次调用后容易出现重复 key、section 混叠、BOM 污染等问题。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 它只是打开文件、fseek 到末尾、fwrite 字符串 —— 不解析原结构，不校验语法
- 如果 ini 原文件是 UTF-8 with BOM，它会把新内容追加成 ANSI，导致文件编码混杂
- 没有错误返回码：成功返回非零，失败也常返回非零（比如路径不存在时），只能靠 GetLastError() 判断
- 避免多线程同时写同一文件：函数内部无锁，两个线程一前一后写，大概率损坏文件
替代方案：用 std::ifstream + 手动解析更可控
与其和 Win32 API 较劲，不如用 C++ 标准库读文件、自己拆 section 和 key。虽然要写十几行，但编码、路径、线程都由你掌控。
立即学习“C++免费学习笔记（深入）”；
- 读取时用
std::wifstream配合imbue(std::locale(""))可正确处理本地化编码（如 GBK） - UTF-8 文件可用
std::ifstream+std::codecvt_utf8<wchar_t></wchar_t>（C++11）或第三方库如 utf8cpp - 写入时用
std::wofstream并 setf(ios::unitbuf) 避免缓冲区残留 - 简单场景推荐 tiny-ini（header-only）：它把
ini::file当 map> 用，不依赖 Windows API
真正麻烦的不是读写逻辑，而是跨机器部署时系统区域设置不同、用户手动编辑过 ini、或者程序升级后字段语义变了——这些 GetPrivateProfileString 一律不管，它只管字面匹配。
