c++如何读取配置文件ini_c++ 字符串分割与键值对解析【技巧】

C++标准库不支持INI文件解析,需手动逐行处理:跳过空行和注释,识别节头[section],按首个=分割键值对并trim,用std::map嵌套存储,访问时应使用find()而非operator[]避免隐式插入。

ini 文件读取在 C++ 中没有标准库支持

标准 C++ 不提供 ReadPrivateProfileString 或类似 Windows API 的跨平台 ini 解析能力。直接手写解析器最可控,尤其当配置简单、依赖最小化时。别指望 std::ifstream 一行读完自动拆成键值对——它只负责读字节,分割和语义识别得自己来。

std::getline + find/substr 拆分每行最稳妥

ini 文件结构松散:空行、注释(;# 开头)、节头 [section]、键值对 key=value。逐行处理比正则更可靠,也避免误匹配。

  • 跳过以 ;# 开头的行(含空格前缀)
  • line.find('=') 找第一个 =,左侧 trim 后是 key,右侧 trim 后是 value
  • 遇到 [section] 时提取 section 名(去掉方括号并 trim),后续键值对归属该 section
  • 注意:value 可能含等号(如 url=https://example.com?a=1&b=2),所以只取第一个 =
std::map> config;
std::string section;
std::ifstream file("config.ini");
std::string line;
while (std::getline(file, line)) {
    // 跳过空行和注释
    auto first = line.find_first_not_of(" \t");
    if (first == std::string::npos || line[first] == ';' || line[first] == '#') continue;
// 匹配 [section]
if (line[first] == '[') {
    auto end = line.find(']', first);
    if (end != std::string::npos) {
        section = line.substr(first + 1, end - first - 1);
        // trim section
        auto l = section.find_first_not_of(" \t");
        auto r = section.find_last_not_of(" \t");
        if (l != std::string::npos) section = section.substr(l, r - l + 1);
    }
    continue;
}

// 解析 key=value
auto eq = line.find('=');
if (eq == std::string::npos) continue;
std::string key = line.substr(0, eq);
std::string value = line.substr(eq + 1);

// trim key 和 value
auto kl = key.find_first_not_of(" \t");
auto kr = key.find_last_not_of(" \t");
auto vl = value.find_first_not_of(" \t");
auto vr = value.find_last_not_of(" \t");
if (kl == std::string::npos || vl == std::string::npos) continue;
key = key.substr(kl, kr - kl + 1);
value = value.substr(vl, vr - vl + 1);

config[section][key] = value;

}

std::string::find_first_not_offind_last_not_of 是 trim 的核心

别用第三方 trim 函数或手写循环——find_first_not_of(" \t")find_last_not_of(" \t") 足够简洁且无额外依赖。Windows 换行符 \r\nstd::getline 下已被自动剥离,无需额外处理 \r;但若文件可能含 Mac 风格 \r,可在 trim 字符集中加 '\r'

  • 空字符串调用 find_first_not_of 返回 npos,必须检查
  • 不要用 boost::trimabsl::StripWhitespace 增加构建复杂度,除非项目已强制引入
  • 如果 value 需要转义(如引号包裹、反斜杠转义),需额外解析逻辑——基础 ini 通常不强制要求

访问键值对时,config["section"]["key"] 容易触发隐式插入

std::map::operator[] 在 key 不存在时会默认构造一个空 entry,导致后续判断 config.count("section") 为 true,但实际没数据。生产环境务必用 at() find()

  • 安全读取:if (auto it = config.find("db"); it != config.end()) { auto& sec = it->second; if (auto kv = sec.find("host"); kv != sec.end()) { host = kv->second; } }
  • 或封装一层:get_value(const std::string& sec, const std::string& key, const std::string& def = ""),内部用 find 避免副作用
  • 不要依赖 config["section"]["key"].empty() 判断是否存在——空字符串可能是合法配置值

真正麻烦的不是分割,而是节名/键名大小写是否敏感、等号前后是否允许空格、注释能否出现在键值行末尾——这些细节决定了你的解析器能不能和现有 ini 工具互通。先看清楚目标文件的实际格式,再决定要不要支持分号后内联注释或 Unicode BOM 处理。