用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)