C++跨平台解析INI文件实现键值对提取

用std::ifstream逐行读取并手动解析INI文件最可靠跨平台，需兼容\r\n/\n/\r换行、trim空格和\r、跳过空行及;#注释、从右找=防URL截断、不自动转义反斜杠、按UTF-8优先处理编码、用小写化哈希表或线性查找解决大小写敏感问题。

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

跨平台解析 INI 文件，不依赖第三方库时，std::ifstream 是唯一稳妥起点。Windows 的 \r\n、Linux/macOS 的 \n、甚至某些编辑器留下的 \r 都得兼容，不能直接用 std::getline 后就假设换行符干净。

• 先用 std::getline 读整行，再手动 trim 掉首尾空格和 \r（line.erase(line.find_last_not_of(" \t\r") + 1)）
• 跳过空行和以 ; 或 # 开头的注释行（注意：INI 标准只认 ;，但很多工具也支持 #，建议兼容）
• 用 line.find('[') 判断 section 行，用 line.find('=') 判断 key-value 行；注意等号前后可能有空格，key 和 value 都要各自 trim
• section 名不用去引号（标准 INI 不加引号），但若遇到带空格的 section 名（如 [User Settings]），只要没被引起来，就按字面解析——这是多数实现的共识行为，不是 bug

避免把 std::string::find 当万能分割器

直接用 line.find('=') 取 value 容易出错：value 里可能含等号（比如 url=http://example.com?a=1&b=2），这时只取第一个 = 就会截断。

• 应从右往左找最后一个 =（line.find_last_of('=')），或更稳妥：跳过开头空白后，找第一个非空白位置后的第一个 =
• value 部分若用双引号包裹（如 path="C:\Program Files\App"），需识别并去除引号，同时处理内部转义（如 "a\"b"）——但纯 C++ 标准解析器通常不处理转义，除非你明确需要
• 如果 value 为空（key=），value 应设为空字符串，而非 nullptr 或未定义值

Windows 下路径分隔符不会影响 INI 解析，但别在 key 名里硬编码 \\

INI 文件本身是文本，不涉及路径操作。但很多人误以为 section 或 key 名里写 [Paths] + root=C:\\MyApp 就要处理反斜杠——其实不用。反斜杠只是普通字符，除非你后续拿这个 value 做文件操作，才需要转换为正斜杠或保持原样传给系统 API。

• 解析阶段，所有字符照单全收，不做任何转义解释
• Windows 上用 CreateFileA 时接受 \\ 和 /；Linux/macOS 上只认 /；所以路径类 value 应留给业务层决定怎么用，解析器只负责“取出字符串”
• 特别注意：若 INI 文件本身是 UTF-16（如 Windows 记事本另存为“Unicode”），std::ifstream 默认按字节读，会乱码。必须用 std::wifstream + std::codecvt_utf16（C++17 起已弃用）或改用 std::filesystem::read_text（C++23）——但绝大多数 INI 仍是 UTF-8 或 ANSI，优先按 UTF-8 处理即可

不要自己写哈希表存 section → map → key/value

用嵌套 std::map> 看似自然，但查 section 时大小写敏感问题立刻暴露：Windows INI 习惯忽略大小写（[Section] 和 [section] 视为同一节），而 std::map 默认区分。

• 要么统一转小写存（std::transform + std::tolower），要么用自定义比较器（但要注意 locale，std::tolower 在非 "C" locale 下可能出错）
• 更轻量做法：用 std::vector 存原始解析结果（每个元素含 section, key, value），查询时线性遍历 + 忽略大小写比较——对几百行的 INI，性能无感，且逻辑清晰不易错
• 如果真要快速查询，推荐封装一个 IniData 类，内部用 std::unordered_map，key 用 std::string 小写化后的哈希值，value 存 std::unordered_map（同样小写化 key）

解析 INI 的难点不在语法，而在边界：空格、注释位置、等号歧义、编码隐式转换、大小写策略。这些地方一松手，Windows 上跑得好好的配置，到 Linux 就读不出值。