多数情况读不到值是因路径、编码或节名大小写不匹配：INI需ANSI编码（非UTF-8），路径避免中文/空格，节名和键名严格区分大小写，缓冲区长度须按字节数传且留足空间，推荐用char buffer[512]并填sizeof(buffer)。
GetPrivateProfileString 为什么读不到值
多数情况不是 API 调用错了，而是路径、编码或节名大小写不匹配。Windows 的 GetPrivateProfileString 默认只认 ANSI 编码的 INI 文件（非 UTF-8），且路径中不能含中文或空格（除非用短文件名或转义）。节名和键名区分大小写——哪怕 INI 文件里写的是 [Settings]，代码里传 "settings" 就返回空字符串。
- 确保 INI 文件保存为 ANSI（记事本另存为时选“ANSI”，不是 UTF-8 或 UTF-8-BOM）
- 路径用绝对路径，避免相对路径导致查找失败；可用
GetModuleFileName拼出同目录下的config.ini - 节名、键名字符串必须完全一致（包括空格），建议用
LPCSTR字面量直接传，别从用户输入拼接 - 缓冲区长度要留足空间，最后一个字节必须是
\0，否则可能读到脏数据
GetPrivateProfileString 参数怎么填才安全
四个核心参数顺序固定：lpAppName（节名）、lpKeyName（键名）、lpDefault（默认值）、lpReturnedString（输出缓冲区）、nSize（缓冲区字节数）、lpFileName（INI 路径）。最容易错的是 nSize：它指字节数，不是字符数；ANSI 下 1 字符 = 1 字节，但若误用 sizeof(buffer) 却定义为 wchar_t buffer[256]，就会传错大小导致截断。
- 缓冲区推荐声明为
char buffer[512] = {}，nSize填sizeof(buffer) -
lpDefault必须是非 NULL 字符串，哪怕传""，传NULL可能触发未定义行为 - 若读取整节所有键值对，用
lpKeyName = NULL，此时lpReturnedString会收到以\0分隔的键名列表，末尾双\0
读不到中文怎么办
原生 GetPrivateProfileString 不支持 UTF-8，也不支持宽字符版（没有 GetPrivateProfileStringW）。如果 INI 文件含中文，又不想改文件编码，唯一稳妥办法是改用其他解析方式——比如自己读文件 + 手动解析，或引入轻量库如 inih（C 风格，头文件仅一个，支持 UTF-8）。
- 强行用 ANSI 编码存中文：依赖系统本地代码页（如 GBK），换到英文系统就乱码，不推荐
- 用
MultiByteToWideChar(CP_UTF8, ...)先把 UTF-8 文件内容转成宽字符串，再按行解析，绕过 API 限制 - 若项目已用 C++17，可直接用
std::filesystem::read_text（需自行实现或用第三方）读文件，再用std::regex提取键值，控制力更强
替代方案比 API 更可靠吗
是的，尤其在跨平台或需要 UTF-8 支持时。GetPrivateProfileString 是 Win95 遗留接口，微软文档明确标注 “This function is provided only for compatibility with 16-bit Windows-based applications”。现代项目中，用 std::ifstream 逐行读 + 简单状态机解析，代码不到 100 行，无编码陷阱，还能加注释支持、嵌套节模拟等扩展。
立即学习“C++免费学习笔记（深入）”；
- inih 库：C 风格回调式解析，
#include "ini.h"即可，支持 UTF-8，无依赖 - Boost.Program_options：重型，适合命令行 + 配置混合场景，INI 只是其中一种输入格式
- 手写解析注意跳过
;开头的注释行、忽略首尾空格、处理引号包裹的值（如path="C:\Program Files\"）
真正麻烦的从来不是“怎么读”，而是“读错时不报错、静默返回默认值”。调试时务必检查返回值是否等于 0（表示没找到键），而不是只看缓冲区内容。
