C++ 读取 INI 配置文件详解与源码实现

为了便于查询，采用双层 Map 结构： Section └── Key -> Value 对应 C++ 类型： std::map<std::string, std::map<std::string, std::string>>

字符串处理基础

解析过程中涉及：

• 去除首尾空格
• 判断注释行
• 查找 = 位置
• 截取字符串

实现思路

整体实现流程如下：

1. 打开 INI 文件
2. 定义当前 Section 名称
3. 逐行读取文件
4. 对每一行进行预处理：
   • 去除首尾空白
   • 忽略空行和注释行
5. 如果是 Section 行：更新当前 Section
6. 如果是 Key=Value 行：解析 Key 和 Value，存入 Map
7. 提供接口函数获取配置值

完整实现代码

/********************************************************
 * 文件名：read_ini.cpp
 * 功能：使用 C++ 读取并解析 INI 配置文件
 * 说明：
 * 1. 支持 Section / Key / Value
 * 2. 忽略注释和空行
 * 3. 使用 map 存储配置数据
 ********************************************************/
#include <iostream>
#include <fstream>
#include <string>
#include <map>

/**
 * @brief 去除字符串首尾空白字符
 * @param str 原始字符串
 * @return 处理后的字符串
 */
std::string trim(const std::string& str) {
    size_t first = str.find_first_not_of(" \t\r\n");
    if (first == std::string::npos) {
        return "";
    }
    size_t last = str.find_last_not_of(" \t\r\n");
    return str.substr(first, last - first + 1);
}

/**
 * @brief INI 文件解析类
 */
class IniReader {
public:
    /**
     * @brief 加载并解析 INI 文件
     * @param fileName INI 文件路径
     * @return true 解析成功
     * @return false 解析失败
     */
    bool load(const std::string& fileName) {
        std::ifstream ifs(fileName);
        if (!ifs.is_open()) {
            return false;
        }
        std::string line;
        std::string currentSection;
        // 按行读取 INI 文件
        while (std::getline(ifs, line)) {
            // 去除首尾空白
            line = trim(line);
            // 跳过空行
            if (line.empty()) {
                continue;
            }
            // 跳过注释行
            if (line[0] == ';' || line[0] == '#') {
                continue;
            }
            // Section 行
            if (line.front() == '[' && line.back() == ']') {
                currentSection = trim(line.substr(1, line.size() - 2));
                continue;
            }
            // Key=Value 行
            size_t pos = line.find('=');
            if (pos == std::string::npos) {
                continue;
            }
            std::string key = trim(line.substr(0, pos));
            std::string value = trim(line.substr(pos + 1));
            // 存储到 map 中
            data_[currentSection][key] = value;
        }
        ifs.close();
        return true;
    }

    /**
     * @brief 获取配置值
     * @param section Section 名称
     * @param key Key 名称
     * @param defaultValue 默认值
     * @return 配置值或默认值
     */
    std::string get(
        const std::string& section,
        const std::string& key,
        const std::string& defaultValue) const {
        auto secIt = data_.find(section);
        if (secIt == data_.end()) {
            return defaultValue;
        }
        auto keyIt = secIt->second.find(key);
        if (keyIt == secIt->second.end()) {
            return defaultValue;
        }
        return keyIt->second;
    }

private:
    // Section -> (Key -> Value)
    std::map<std::string, std::map<std::string, std::string>> data_;
};

int main() {
    IniReader reader;
    if (!reader.load("config.ini")) {
        std::cerr << "读取 INI 文件失败！" << std::endl;
        return 1;
    }
    // 示例读取配置项
    std::string dbHost = reader.get("Database", "host", "localhost");
    std::string dbPort = reader.get("Database", "port", "3306");
    std::string serverPort = reader.get("Server", "port", "8080");
    std::cout << "Database Host: " << dbHost << std::endl;
    std::cout << "Database Port: " << dbPort << std::endl;
    std::cout << "Server Port: " << serverPort << std::endl;
    return 0;
}

代码解读

trim 方法

• 用于去除字符串首尾的空格、Tab、换行符
• 是解析 INI 文件时的基础工具函数

IniReader::load

• 打开并逐行读取 INI 文件
• 忽略空行和注释
• 解析 Section 与 Key=Value
• 将结果存储到嵌套 map 结构中

IniReader::get

• 根据 Section + Key 查询配置值
• 如果不存在，返回默认值
• 避免程序因缺失配置而崩溃

main 函数

• 创建解析器对象
• 加载配置文件
• 读取并使用配置项

总结

通过本项目，已经系统掌握：

• INI 文件格式规范
• C++ 文本文件解析流程
• 字符串处理技巧
• 配置数据结构设计思想
• 可扩展配置管理的基础架构

该实现方式简单、可靠、无第三方依赖，非常适合教学、工具程序、嵌入式系统、基础服务组件。

常见问题

Q1：是否支持中文 Key / Value？

支持。INI 是纯文本格式，与编码无关。

Q2：是否支持大小写不敏感？

当前实现区分大小写，可在 trim 后统一转小写扩展。

Q3：是否支持同名 Key？

后出现的 Key 会覆盖前一个值。

Q4：如果没有 Section 怎么办？

会存储在空字符串 Section 下。

扩展方向

9.1 增加 getInt / getBool / getDouble

9.2 支持配置热加载（文件变更检测）

9.3 保留注释并支持原地修改

9.4 与 IniWriter 合并为完整配置模块

9.5 使用 unordered_map 提升查询性能