C++如何读取INI配置文件？（轻量解析器示例）

最可靠的ini解析方式是用std::ifstream逐行读取并手动解析：跳过注释与空行，trim首尾空白，识别[section]和key=value，注意等号位置及大小写处理，严格校验格式并记录解析统计。

用 std::ifstream 逐行读取 + 手动解析最可靠

INI 文件没有统一标准，第三方库（如 inih 或 SimpleIni）常因编译器差异、宽字符支持或内存模型问题出错。自己写一个轻量解析器反而更可控，尤其当配置项少、格式固定时。

关键不是“能不能读”，而是“怎么避免把注释当键值”“怎么跳过空行和缩进”“怎么处理带等号的值”。

• 用 std::getline() 逐行读，别用 operator>> —— 后者会跳过空白并截断含空格的值
• 每行先 trim()（手动实现：用 find_first_not_of(" trn") 和 find_last_not_of(" trn")）
• 跳过以 ; 或 # 开头的行（注释），也跳过空行
• 遇到 [section] 就更新当前 section；遇到 key = value 就存入 std::map<:String std::map std::string>></:string>

std::string::find('=') 前必须检查是否在注释之后

常见错误是直接找第一个 =，结果把 ; timeout = 30 当成有效键值对。实际要先跳过开头的空白和分号/井号。

• 先用 find_first_not_of(" t") 定位非空白起始位置
• 若该位置是 ';' 或 '#'，整行忽略
• 再从该位置开始找 '='，且确保它不在引号内（简单场景可忽略引号；若需支持，得手写状态机）
• 分割 key/value 时，value 部分也要 trim —— 很多人只 trim key，导致 port = 8080 存成 "8080 "

section 名称大小写敏感性由你决定，但必须显式声明

windows 下 INI 默认不区分大小写，linux 工具常区分。c++ 标准库没内置 case-insensitive map，所以你得选：

立即学习“C++免费学习笔记（深入）”；

• 统一转小写存 key 和 section（用 std::tolower 遍历每个 char）
• 或保留原样，查的时候手动转换比较 —— 别依赖 std::map 的默认排序
• 注意：Unicode 不适用 std::tolower，纯 ASCII 配置才安全
• 如果项目已用 std::unordered_map，记得自定义哈希和比较函数，否则大小写不同就查不到

别自动创建缺失 section，也别静默丢弃非法行

看似省事的“容错逻辑”反而让调试变难。比如把 [db 当成 [db]，或把 user:pass 当成 user = pass，后续访问时崩溃才暴露问题。

• 遇到无闭合括号的 section 行，直接报错并返回 false（或抛 std::runtime_error）
• 遇到无等号的非 section 行，记录警告（用 std::cerr），但不停止解析
• 值中含换行？INI 规范不支持，直接截断或报错 —— 别尝试跨行拼接，那是 YAML 的事
• 路径传参建议用 const std::string&，避免 Windows 下 L"config.ini" 强转出错

真正麻烦的从来不是读文件，而是有人改了 INI 格式却没通知你——加一行日志输出实际解析到的 section 数和 key 总数，比任何文档都管用。