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

用C++写一个轻量级INI解析器,核心在于:按行读取、识别节([section])、键值对(key=value)、忽略注释与空行,并支持基础的字符串去空格和转义。不需要第三方库,标准库 <fstream>、<string>、<map> 就够用。
INI文件结构与解析逻辑
典型INI格式如下:
[database] host = 127.0.0.1 port = 3306 ; 这是注释 user = admin <p>[logging] level = debug enabled = true
关键规则:
- 以 [ 开头、] 结尾的行是节名(如
[database]) - 不含 [ 和 ] 的非空行,且含 =,视为键值对(如
host = 127.0.0.1) - 行首为 ; 或 # 视为注释,跳过
- 自动裁掉键、值两端空格;等号前后空格不干扰解析
核心数据结构设计
用嵌套 map 表达层级关系:
立即学习“C++免费学习笔记(深入)”;
std::map<std::string, std::map<std::string, 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 <iostream>
#include <fstream>
#include <string>
#include <map>
#include <algorithm>
<p>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);
}</p><p>int main() {
std::ifstream file("config.ini");
if (!file.is_open()) {
std::cerr << "无法打开 config.ini\n";
return 1;
}</p><pre class='brush:php;toolbar:false;'>std::map<std::string, std::map<std::string, std::string>> 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 << "[" << sec.first << "]\n";
for (const auto& kv : sec.second) {
std::cout << " " << kv.first << " = " << kv.second << "\n";
}
}}
编译运行前,把上面内容存为 config.ini 放在同一目录即可验证。
基本上就这些。不复杂但容易忽略 trim 和节名为空的边界情况。后续可扩展:支持多行值、内联注释(key=value ; comment)、Unicode、写回保存——但日常配置读取,这个骨架已足够扎实。










