通八洲科技

NEWS CENTER 新闻中心

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

日期：2025-12-12 00:00 / 作者：尼克
上一篇 下一篇
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

关键规则：

核心数据结构设计

用嵌套 map 表达层级关系：

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

逐行解析与字符串清洗

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

完整可运行示例（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、写回保存——但日常配置读取，这个骨架已足够扎实。