C++ 读取 INI 配置文件详解与源码实现。文章基于纯 C++ 标准库，实现了一个完整的 INI 文件读取类 IniReader。核心功能包括解析 Section 节、Key=Value 键值对，支持忽略注释和空行，使用双层 Map 结构存储数据。提供了 load 加载文件和 get 查询接口，并包含默认值处理。代码兼容跨平台，适用于轻量级应用、嵌入式系统及工具程序。文中还涵盖了字符串处理技巧、数据结构设计思想及常见问题解答。
在真实的软件系统中，读配置是程序运行时最核心的能力。几乎所有非硬编码的程序，启动流程都会包含如下步骤：
在轻量级应用、工具程序、跨平台项目、嵌入式系统中，INI 文件仍然是最常见、最稳定、最低依赖的配置方式之一。 典型使用场景包括：
因此，掌握如何用 C++ 正确读取 INI 文件是一项非常基础但极其重要的能力。本项目将从零开始，使用纯 C++ 标准库，实现一个完整、可扩展、工程级的 INI 文件读取示例，并系统讲解其设计与实现思路。
本项目需要实现以下核心功能：
为了满足教学与工程实践：
; 示例配置文件
[Database]
host = 127.0.0.1
port = 3306
user = root
password = 123456
[Server]
ip = 0.0.0.0
port = 8080
INI 文件由三种元素组成：
; 或 # 开头[SectionName]key = value使用 std::getline(inputFile, line);
优点：
为了便于查询，采用双层 Map 结构：
Section └── Key -> Value
对应 C++ 类型：
std::map<std::string, std::map<std::string, std::string>>
解析过程中涉及：
= 位置整体实现流程如下：
/********************************************************
* 文件名：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;
}
通过本项目，已经系统掌握：
该实现方式简单、可靠、无第三方依赖，非常适合教学、工具程序、嵌入式系统、基础服务组件。
支持。INI 是纯文本格式，与编码无关。
当前实现区分大小写，可在 trim 后统一转小写扩展。
后出现的 Key 会覆盖前一个值。
会存储在空字符串 Section 下。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online