ini文件基本结构为[section]分块、key=value键值对、;或#开头注释；解析难点在于空格处理、换行/引号值、重复键节覆盖、bom头识别及无标准库支持，需用getline逐行控制并手动状态机解析。
INI文件的基本结构和解析难点在哪
INI 文件本质是纯文本，但有隐含规则：用 [section] 划分区块，key=value 定义键值对，支持分号 ; 或井号 # 开头的行注释。实际解析时容易踩的坑不是语法本身，而是边界情况——比如等号前后有空格要不要保留、值里含换行或引号怎么处理、重复 section 或 key 怎么覆盖、BOM 头导致读取失败。
C++ 标准库不提供原生 INI 解析，得自己拆行、切字段、状态机维护 section 上下文。别想着一步到位支持所有 ini 变体（如 Windows 扩展的 @= 语法），先搞定最常见场景：单字节编码（UTF-8 或 ANSI）、无嵌套、无转义。
用 std::ifstream 逐行读取并跳过注释和空行
核心是别用 operator>>——它会跳过空白、吃掉等号前后的空格，破坏原始格式。改用 std::getline 保证整行可控：
std::ifstream file("config.ini");
std::string line;
std::string current_section;
while (std::getline(file, line)) {
// 去首尾空格（但保留中间空格！）
line.erase(0, line.find_first_not_of(" \t"));
line.erase(line.find_last_not_of(" \t") + 1);
if (line.empty() || line[0] == ';' || line[0] == '#') continue;
// ...
}
注意点：
-
find_first_not_of和find_last_not_of传入" \t"而非" "，否则制表符没被清理 - 不要用
std::istringstream拆key=value，因为值可能含等号（如url=@#@#@#@#@#@#@#@#@#@0），必须从右往左找第一个= - 遇到
[section]行，用line.substr(1, line.size()-2)提取 section 名，再 trim 一次
用 std::map<:string std::map std::string>></:string> 存储数据
这是最直白的内存结构：外层 key 是 section 名，内层 key 是配置项名，value 是字符串值。好处是查找快、逻辑清晰；缺点是不支持同一 section 下重复 key（INI 规范本就不允许，但有些工具会写多行同 key 当数组用——那是扩展需求，先不碰）。
示例存值逻辑：
size_t pos = line.find('=');
if (pos != std::string::npos) {
std::string key = line.substr(0, pos);
std::string value = line.substr(pos + 1);
// trim key 和 value 的首尾空格（但保留中间空格！）
key.erase(0, key.find_first_not_of(" \t"));
key.erase(key.find_last_not_of(" \t") + 1);
value.erase(0, value.find_first_not_of(" \t"));
value.erase(value.find_last_not_of(" \t") + 1);
config[current_section][key] = value;
}
关键细节：
-
std::map插入时自动创建嵌套 map，不用手动判空 - 如果需要区分“未设置”和“空字符串”，value 类型得换成
std::optional<:string></:string>，但多数场景空字符串就是有效值 - 不要对 value 做额外 trim（比如删掉引号），除非明确知道输入格式带包围引号且需剥离
读取后如何安全获取值？用 at() 而非 [] 操作符
config["network"]["port"] 看似方便，但若 "network" section 不存在，[] 会静默插入空 map，掩盖配置缺失问题。正确做法是分层检查或用异常：
try {
auto& sec = config.at("database"); // 若不存在抛 out_of_range
std::string host = sec.at("host"); // 同理
int port = std::stoi(sec.at("port")); // 注意转换失败异常
} catch (const std::out_of_range&) {
// 配置项缺失
} catch (const std::invalid_argument&) {
// port 不是数字
}
更稳健的封装建议：
- 写个
get_string(const std::string& section, const std::string& key, const std::string& default_val = "")方法，内部用find()+at() - 数值类型转换统一用
std::from_chars（C++17）避免异常开销，但得自己处理截断和溢出
真正麻烦的从来不是解析本身，而是后续使用时没人记得检查 section 是否存在、key 是否拼错、值是否为空——这些错误在编译期完全不报，运行时才崩，所以封装一层带默认值和类型转换的访问接口，比 parser 本身更重要。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
