INI文件读取本质是键值对解析，C++无标准库支持，常用inih库（单头文件、回调式解析）或手写解析器，Windows下可用GetPrivateProfileString但需注意编码、路径和缓冲区问题。
INI 文件读取本质是键值对解析，C++ 没有标准库支持，必须借助第三方或手写解析器
标准 C++ 不提供 GetPrivateProfileString 或类似 INI 解析接口，Windows API 的 GetPrivateProfileString 仅限 Windows 平台且依赖 kernel32.lib，跨平台项目中基本不可用。多数实际项目选择轻量级第三方库（如 inih）或封装简单的行扫描逻辑——关键不是“能不能读”，而是“要不要支持节嵌套、注释、转义、空格容忍”等细节。
用 inih 库读取 INI 最省心，头文件即用，无需编译
inih 是纯 C 实现的单头文件库（ini.h + ini.c），C++ 项目可直接 #include 使用。它不构建内存结构，而是通过回调函数逐行通知解析结果，内存占用极低，适合嵌入式或配置项较少的场景。
典型用法：
// callback 函数
int handler(void* user, const char* section, const char* name, const char* value) {
if (strcmp(section, "database") == 0 && strcmp(name, "port") == 0) {
*(int*)user = atoi(value); // 假设 user 指向 int port;
}
return 1; // 继续解析
}
<p>// 调用
int port = 0;
ini_parse("config.ini", handler, &port);
-
ini_parse第二个参数是回调函数，第三个是传给它的上下文指针，适合传递多个变量地址（例如用 struct 封装） - 不支持
[section:sub]这类嵌套节名，遇到未知格式会跳过整行 - 注释以
;或#开头，会被自动忽略；键名前后空格被保留，值前后空格默认不 trim（需手动strtrim）
Windows 下用 GetPrivateProfileString 需注意路径和 Unicode 问题
若只面向 Windows 桌面程序，且配置文件路径固定，可用系统 API 快速读取，但容易踩坑：
立即学习“C++免费学习笔记（深入）”；
-
GetPrivateProfileString默认按 ANSI 编码读取，若 INI 文件是 UTF-8 无 BOM，中文会乱码；建议改用GetPrivateProfileStringW并确保文件保存为 UTF-16 LE（记事本另存为时可选） - 路径必须是绝对路径或相对于当前工作目录；相对路径在 IDE 调试时可能指向项目根目录，而发布后指向 exe 所在目录，建议用
GetModuleFileName拼出配置文件全路径 - 缓冲区大小必须足够，否则截断；返回值是实际复制的字符数（不含
\0），不能直接当字符串长度用
示例：
TCHAR buffer[256] = {0};
GetPrivateProfileString(_T("network"), _T("host"), _T("localhost"),
buffer, _countof(buffer), _T("app.ini"));
// buffer 现在含 host 值，注意末尾有 \0
手写简易解析器要防住换行、空行、注释和等号位置异常
如果项目不允许引入外部依赖，又只需读几个固定 key，手写解析器比想象中更可靠，但必须处理这些边界：
- 一行含多个
=（如url=http://a=b/c?d=e）：应取第一个等号左边为 key，右边全部为 value - key 或 value 包含空格（如
log path = D:\my logs\）：不能简单strtok(" =", " \t")，需手动找首个非空白后的= - 注释在行尾（
timeout=30 ; seconds）：找到=后，再跳过右侧空格，检查是否以;或#开头 - 空行、纯空格行、只有注释的行：跳过，不要当作 section 或 key
核心逻辑片段（C++17）：
std::string line;
while (std::getline(file, line)) {
auto pos = line.find_first_not_of(" \t\r\n");
if (pos == std::string::npos || line[pos] == ';' || line[pos] == '#') continue;
if (line[pos] == '[' && line.find(']', pos) != std::string::npos) {
// 解析 section
} else if (auto eq = line.find('='); eq != std::string::npos) {
std::string key = trim(line.substr(pos, eq - pos));
std::string val = trim(line.substr(eq + 1));
// 去掉 val 尾部的 ; 注释
if (auto cmt = val.find_first_of(";#"); cmt != std::string::npos) {
val.erase(cmt);
}
config[key] = trim(val);
}
}
真正麻烦的从来不是“读到值”，而是“下次 INI 格式微调后，你的解析逻辑是否还健壮”。尤其当配置由运维手工修改时，多一个空格、少一个引号、错位的分号，都可能让程序静默读错值。宁可多花十分钟加几行 trim 和容错判断，也不要赌用户一定按文档格式写。
