INI文件虽然出现得很早，但在桌面工具、游戏客户端和嵌入式配置里仍然很常见。它的好处是纯文本、结构直观，用记事本就能改。可要用C++安全地读取它，至少得处理三个问题：节和键的大小写是否敏感、行尾和值两侧的空白要不要忽略、遇到分号或井号注释时如何跳过。下面这份轻量解析器会把这些问题逐个解决，并且不依赖任何第三方库。

一、INI文件的结构与必须避开的坑

一个典型的INI文件由节、键值对和注释组成。节名放在方括号里，键值对以等号分隔，注释常用分号或井号开头。比如下面这个配置，既有字符串值，也有数字和路径。路径中的反斜杠在Windows环境下很常见，解析时不需要做替换，保存原文即可。

[Server]
Host=127.0.0.1
Port=8080
Timeout=30
[Log]
Level=debug
Path=C:\logs\app.log

真正写解析器时，陷阱往往不在格式本身，而在那些不显眼的细节：文件开头可能带UTF-8 BOM头，导致第一个节名读不到；行尾可能有回车符，字符串比较时会莫名失败；值里可能含空格，直接截取会把空格带进结果。还有一个容易忽略的问题是重复键，不同INI库对这个行为的处理并不一致，有的是后者覆盖前者，有的保留最后一次出现。轻量实现中通常会选择让后面的值覆盖前面的，这样操作简单，也符合大多数编辑器的直觉。

解析目标可以概括为：把文件内容读进一个两级映射结构，第一级是节名到该节下所有键值对的映射，第二级是键名到字符串值的映射。这种结构在C++里用std::map或std::unordered_map都很合适。选择std::map的好处是键自动排序，调试时输出内容更整齐；如果对性能有要求，可以换成unordered_map。

二、轻量解析器代码实现

实现时不需要复杂的状态机，只需要一重循环逐行读取。每读一行先做Trim，去掉首尾空白；如果行是空的，或者以分号、井号开头，直接跳过。如果行以左方括号开头且以右方括号结尾，就把它识别为新节，更新当前节名。其他情况尝试用等号拆分，拆不出键值对就忽略，防止坏数据干扰整次加载。

下面是一个可直接编译运行的解析器类。它把加载逻辑放在Load函数中，把读取逻辑封装成GetString和GetInt。为了让代码保持轻量，这里没有引入boost或第三方解析库，只用标准库的ifstream、sstream、map和stoi。代码中的Trim函数负责统一裁剪空格、制表符和换行符。

#include <iostream>
#include <fstream>
#include <sstream>
#include <map>
#include <string>
#include <algorithm>
class IniParser {
public:
    bool Load(const std::string& filename) {
        std::ifstream file(filename);
        if (!file.is_open()) return false;
        std::string line, section;
        while (std::getline(file, line)) {
            line = Trim(line);
            if (line.empty() || line[0] == ';' || line[0] == '#') continue;
            if (line[0] == '[' && line[line.size()-1] == ']') {
                section = line.substr(1, line.size()-2);
            } else {
                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));
                data_[section][key] = value;
            }
        }
        return true;
    }
    std::string GetString(const std::string& section, const std::string& key, const std::string& def = "") const {
        auto s = data_.find(section);
        if (s != data_.end()) {
            auto k = s->second.find(key);
            if (k != s->second.end()) return k->second;
        }
        return def;
    }
    int GetInt(const std::string& section, const std::string& key, int def = 0) const {
        std::string v = GetString(section, key);
        if (v.empty()) return def;
        try { return std::stoi(v); } catch (...) { return def; }
    }
private:
    std::map<std::string, std::map<std::string, std::string>> data_;
    static std::string Trim(const std::string& s) {
        size_t start = s.find_first_not_of(" \t\r\n");
        if (start == std::string::npos) return "";
        size_t end = s.find_last_not_of(" \t\r\n");
        return s.substr(start, end - start + 1);
    }
};

Load函数的核心是维护一个当前节名。遇到节头时更新section变量，后续键值对就写入data_[section]。这里data_的类型是std::map<std::string, std::map<std::string, std::string>>，外层键为节名，内层键为配置项名。GetString先查找节，再查找键，找不到时返回调用方传入的默认值。GetInt则在字符串基础上用std::stoi转换，一旦转换异常就回退默认值，避免程序崩溃。

三、类型转换与读取接口的完善

只返回字符串往往不够，配置项还可能是整数、布尔值、浮点数甚至枚举。为了让调用方少写重复代码，可以在类里扩展几个薄封装方法，比如GetBool和GetDouble。这样做的好处是类型转换逻辑集中在一个地方，默认值也统一处理，调用方不用每次都写try-catch。

#include <iostream>
#include "IniParser.h"
int main() {
    IniParser ini;
    if (!ini.Load("config.ini")) {
        std::cout << "open failed" << std::endl;
        return 1;
    }
    std::string host = ini.GetString("Server", "Host", "localhost");
    int port = ini.GetInt("Server", "Port", 80);
    std::string logPath = ini.GetString("Log", "Path", "");
    std::cout << "host=" << host << " port=" << port << std::endl;
    std::cout << "log path=" << logPath << std::endl;
    return 0;
}

GetBool没有写进上面的类，但实现起来也很简单：把字符串统一转成小写，如果等于true、1、yes、on就返回真；等于false、0、no、off就返回假；其他情况返回调用方给的默认值。浮点数解析可以使用std::stod，同样用try-catch兜底。这些封装让读取配置的代码保持整洁，也不容易把异常抛到业务层。

四、对比系统API与后续优化方向

Windows开发者可能习惯用GetPrivateProfileString和GetPrivateProfileInt，这两个API确实能快速读取INI，不用自己解析。但它们有几个明显限制：只适用于Windows平台，函数调用一次只能取一个值，频繁读取会有文件I/O开销；此外，如果文件不存在或节名拼错，API会返回默认值，但没有错误信息，排查配置问题比较被动。所以跨平台项目通常会选择自定义解析器或成熟开源库。

自定义解析器虽然要写几十行代码，但换来的是跨平台和完全可控。比如你可以把注释符号定义为分号和井号，有些INI文件仅接受分号；你也可以决定节名是否区分大小写。本文实现中节名和键名都严格区分大小写，如果需要大小写不敏感，把外层和内层map换成带自定义比较器的容器即可。

如果后续想让解析器更健壮，可以从几个方向扩展：支持带引号的值，让值内部可以包含分号或等号；解析列表项，例如把逗号分隔的字符串拆成vector；提供枚举所有节和键的接口，便于生成配置模板；加载失败时记录行号和原因，而不仅仅是返回false。这些小改进累积起来，就能让它适用于更复杂的配置场景。总体来说，INI解析本身并不复杂，难的是把细节处理稳妥。掌握这个百行左右的实现之后，遇到类似格式的配置文件也可以快速改造。