如何用C++写一个INI配置文件解析器?C++文件IO与字符串处理实战【项目练习】

C++轻量级INI解析器使用标准库实现:按行读取文件,识别节名([section])、键值对(key=value),跳过注释与空行,自动trim两端空格,用嵌套map存储配置,支持config"section"访问。

用C++写一个轻量级INI解析器,核心在于:按行读取、识别节([section])、键值对(key=value)、忽略注释与空行,并支持基础的字符串去空格和转义。不需要第三方库,标准库 够用。

INI文件结构与解析逻辑

典型INI格式如下:

[database]
host = 127.0.0.1
port = 3306
; 这是注释
user = admin

[logging] level = debug enabled = true

关键规则:

  • [ 开头、] 结尾的行是节名(如 [database]
  • 不含 [] 的非空行,且含 =,视为键值对(如 host = 127.0.0.1
  • 行首为 ;# 视为注释,跳过
  • 自动裁掉键、值两端空格;等号前后空格不干扰解析

核心数据结构设计

用嵌套 map 表达层级关系:

  • std::map<:string std::map std::string>> config;
  • 外层 key 是节名("database"),内层是键值对("host" → "127.0.0.1"
  • 访问示例:config["database"]["port"] 得到 "3306"(字符串)

如果需要类型安全转换(比如转 int/bool),可额外封装 get_int()、get_bool() 方法,内部调用 std::stoi 或字符串比对。

逐行解析与字符串清洗

重点在三步处理:去首尾空格、跳过注释/空行、拆分键值。

  • std::getline() 按行读取文件
  • 写个辅助函数 trim(const std::string& s):用 s.find_first_not_of(" \t")s.find_last_not_of(" \t") 截取有效子串
  • 判断节名:line.starts_with("[") && line.ends_with("]")(C++20);老标准可用 line[0]=='[' && line.back()==']',再 trim 内容
  • 判断键值对:找第一个 '=',左边 trim 后是 key,右边 trim 后是 value;注意等号可能不存在,需判空

完整可运行示例(C++17 兼容)

以下是最简可用版本,无异常处理但逻辑清晰:

#include 
#include 
#include 
#include 
#include 

std::string trim(const std::string& s) { size_t l = s.find_first_not_of(" \t\r\n"); if (l == std::string::npos) return ""; size_t r = s.find_last_not_of(" \t\r\n"); return s.substr(l, r - l + 1); }

int main() { std::ifstream file("config.ini"); if (!file.is_open()) { std::cerr << "无法打开 config.ini\n"; return 1; }

std::mapzuojiankuohaophpcnstd::string, std::mapzuojiankuohaophpcnstd::string, std::stringyoujiankuohaophpcnyoujiankuohaophpcn config;
std::string section, line;
while (std::getline(file, line)) {
    line = trim(line);
    if (line.empty() || line[0] == ';' || line[0] == '#') continue;

    if (line[0] == '[' && line.back() == ']') {
        section = trim(line.substr(1, line.length() - 2));
    } else if (line.find('=') != std::string::npos) {
        size_t pos = line.find('=');
        std::string key = trim(line.substr(0, pos));
        std::string value = trim(line.substr(pos + 1));
        if (!section.empty() && !key.empty()) {
            config[section][key] = value;
        }
    }
}

// 示例输出
for (const auto& sec : config) {
    std::cout zuojiankuohaophpcnzuojiankuohaophpcn "[" zuojiankuohaophpcnzuojiankuohaophpcn sec.first zuojiankuohaophpcnzuojiankuohaophpcn "]\n";
    for (const auto& kv : sec.second) {
        std::cout zuojiankuohaophpcnzuojiankuohaophpcn "  " zuojiankuohaophpcnzuojiankuohaophpcn kv.first zuojiankuohaophpcnzuojiankuohaophpcn " = " zuojiankuohaophpcnzuojiankuohaophpcn kv.second zuojiankuohaophpcnzuojiankuohaophpcn "\n";
    }
}

}

编译运行前,把上面内容存为 config.ini 放在同一目录即可验证。

基本上就这些。不复杂但容易忽略 trim 和节名为空的边界情况。后续可扩展:支持多行值、内联注释(key=value ; comment)、Unicode、写回保存——但日常配置读取,这个骨架已足够扎实。