当前位置：首页 > news >正文

C++ INI文件读写器实现：从设计到源码的完整指南

news 2026/7/25 6:55:55

1. 项目概述：为什么INI文件在C++项目中依然重要？

在接手一个C++项目，尤其是涉及到配置管理时，我们常常会面临一个选择：配置文件用什么格式？XML、JSON、YAML，还是INI？尽管INI格式看起来有些“古老”，远不如JSON或YAML那样功能强大和结构化，但在很多场景下，它依然是C++开发者的心头好。原因很简单：简单、直观、易读。一个典型的INI文件，比如config.ini，内容可能就是下面这样：

[Database] Server=127.0.0.1 Port=3306 Username=root Password=secret [Log] Level=INFO FilePath=/var/log/myapp.log MaxSize=10MB

这种键值对加节（Section）的结构，对于人类阅读和手动编辑极其友好。在开发桌面应用、游戏、嵌入式系统，或者是一些需要轻量级、快速启动的工具时，INI文件因其零依赖（不需要引入额外的解析库）和极低的解析开销，成为了一个非常务实的选择。很多Windows平台上的遗留软件和系统配置（比如经典的win.ini）也大量使用INI格式，这使得在C++，特别是涉及Win32 API的编程中，读写INI文件成为一项基础技能。

然而，C++标准库并没有提供原生的INI文件解析功能。这意味着我们需要自己动手，从文件I/O开始，实现一套解析逻辑。这个过程看似简单，实则暗藏玄机：如何高效地解析节和键值？如何处理空格和注释？如何保证读写操作的线程安全（如果需要的话）？如何设计一个清晰易用的API？这正是本篇文章要深入探讨的。我将不仅提供一个可以直接编译使用的源码，更会拆解其中的每一个设计决策和实现细节，分享我在实际项目中踩过的坑和总结的经验。无论你是C++新手想了解文件操作和字符串处理，还是有经验的开发者想重构自己的配置管理模块，相信都能从中获得启发。

2. 核心设计思路：从需求到接口的权衡

在动手写代码之前，我们先要明确这个INI读写器需要满足哪些核心需求。这决定了我们的设计方向和接口形态。

2.1 功能需求拆解

首先，一个最基本的INI读写器应该能做什么？

读取：从指定的INI文件中加载配置，并能通过节名和键名快速获取对应的字符串值。
写入：将内存中的配置数据（可能是修改后的）保存回INI文件。
修改：支持在内存中增加、删除、修改节和键值对。
基础解析：正确识别节（如[Section]）、键值对（如Key=Value）、忽略注释（通常以;或#开头）和空行。

但仅仅满足这些，离一个“好用”的工具还有距离。我们还需要考虑一些增强需求： 5.类型转换：配置值通常是字符串，但我们在代码中可能需要int,double,bool等类型。提供类型安全的获取和设置接口会极大方便调用方。 6.默认值：当请求的键不存在时，返回一个用户指定的默认值，而不是抛出异常或返回空字符串，这能使代码更健壮。 7.值存在性检查：能够查询某个节或键是否存在。 8.空格处理：INI格式宽松，键和值前后的空格是否保留？我们通常选择自动修剪（trim），避免因格式不统一导致的问题。 9.编码问题：简单起见，我们通常假设INI文件使用系统本地编码（如Windows下的GBK或ANSI）或UTF-8 without BOM。对于更复杂的Unicode支持，需要额外处理。

2.2 接口设计：在易用性与灵活性之间找平衡

基于以上需求，我设计了一个名为IniFile的类。它的公共接口力求简洁明了：

class IniFile { public: // 构造与析构 explicit IniFile(const std::string& filename); ~IniFile() = default; // 核心读写接口 bool Load(); // 从文件加载 bool Save(const std::string& filename = ""); // 保存到文件（默认保存到加载的文件） // 值读取接口（支持默认值） std::string GetStringValue(const std::string& section, const std::string& key, const std::string& default_value = ""); int GetIntValue(const std::string& section, const std::string& key, int default_value = 0); double GetDoubleValue(const std::string& section, const std::string& key, double default_value = 0.0); bool GetBoolValue(const std::string& section, const std::string& key, bool default_value = false); // 值设置接口 void SetStringValue(const std::string& section, const std::string& key, const std::string& value); void SetIntValue(const std::string& section, const std::string& key, int value); void SetDoubleValue(const std::string& section, const std::string& key, double value); void SetBoolValue(const std::string& section, const std::string& key, bool value); // 工具接口 bool HasSection(const std::string& section) const; bool HasKey(const std::string& section, const std::string& key) const; void DeleteSection(const std::string& section); void DeleteKey(const std::string& section, const std::string& key); // 获取所有节名或某个节下所有键名（用于遍历） std::vector<std::string> GetSectionNames() const; std::vector<std::string> GetKeyNames(const std::string& section) const; private: // 内部数据存储与解析实现 std::string m_filename; std::map<std::string, std::map<std::string, std::string>> m_data; // 嵌套map存储数据 // ... 其他私有成员和方法 };

设计考量：

文件名作为构造参数：在构造时即绑定一个文件，符合“一个对象对应一个文件”的直观认知。Load和Save方法则专注于执行I/O操作。
重载的Get/Set方法：为不同类型提供专门的方法，内部进行字符串转换。这比让用户自己调用std::stoi或std::to_string更安全、更方便。Get方法提供默认值参数是防止访问不存在的键导致程序逻辑中断的常见做法。
使用std::map嵌套存储：这是最自然的数据结构。外层map的key是节名（std::string），value是另一个map，内层map的key是键名，value是字符串值。这种结构保证了节和键的唯一性，并且查找效率是O(log n)，对于通常不大的配置文件来说完全足够。
const正确性：查询方法（如GetStringValue,HasSection）标记为const，表明它们不会修改对象状态，这是良好的API设计习惯。
返回std::vector用于遍历：虽然暴露了内部数据结构的部分信息，但提供了遍历所有配置的可行性，满足了高级需求。

注意：这里没有采用单例模式或全局静态类。因为一个程序完全可能读写多个不同的INI文件。将功能封装在一个可以实例化的类中，灵活性更高。

3. 关键实现细节与避坑指南

有了清晰的接口设计，接下来我们深入实现层。这里面的每一个细节都决定了代码的健壮性和效率。

3.1 文件读取与行解析

Load()函数的核心是逐行读取文件并解析。我们使用std::ifstream和std::getline。

bool IniFile::Load() { std::ifstream inFile(m_filename); if (!inFile.is_open()) { // 文件打开失败，可能是文件不存在。这里不视为错误，只是清空现有数据。 m_data.clear(); return false; // 或者可以根据需求返回true，表示“加载了一个空配置” } m_data.clear(); // 加载新文件前清空旧数据 std::string current_section; // 当前所属的节名，默认为空（表示全局节？） std::string line; while (std::getline(inFile, line)) { // 第一步：预处理行 Trim(line); // 移除首尾空白字符 // 跳过空行和注释行 if (line.empty() || line[0] == ';' || line[0] == '#') { continue; } // 第二步：判断是否为节头 if (line.front() == '[' && line.back() == ']') { current_section = line.substr(1, line.length() - 2); // 提取节名 Trim(current_section); // 节名也可能需要修剪空格 if (current_section.empty()) { // 节名为空是无效的，可以选择忽略或记录警告 current_section.clear(); } // 确保在m_data中为该节创建一个空的map条目，即使它下面还没有键值对。 m_data[current_section]; continue; } // 第三步：解析键值对 size_t equals_pos = line.find('='); if (equals_pos != std::string::npos) { std::string key = line.substr(0, equals_pos); std::string value = line.substr(equals_pos + 1); Trim(key); Trim(value); if (!key.empty()) { // 如果current_section为空，我们可以选择将其存储在一个特殊的“全局”节下（如空字符串""）， // 但更常见的INI规范是节外的键值对无效。这里我们选择忽略没有节的键值对。 if (!current_section.empty()) { m_data[current_section][key] = value; } // 否则，忽略此行 } } // 如果没有找到‘=’，则忽略该行（可能是格式错误的行） } inFile.close(); return true; }

关键点与避坑指南：

Trim函数：这是一个需要自己实现的辅助函数，用于去掉字符串首尾的空白字符（空格、制表符\t等）。使用std::isspace在循环中判断是实现方式之一。务必在解析节名、键、值后立即调用，避免后续比较和存储时受空格干扰。
注释处理：这里只处理了行首的;和#。更严格的解析器可能还需要处理行内注释（如Key=Value ; comment）。如果支持，需要在找到键值对后，在value中查找注释符号并截断。为了简单和通用性，我的实现通常不支持行内注释。
节名有效性：[ ]是无效的节名。遇到这种情况，我选择清空current_section，后续的键值对将被忽略，直到遇到下一个有效的节。你也可以选择抛出一个异常或记录错误。
“全局”节问题：有些INI解析器允许节定义之前的键值对，将它们归属于一个隐式的全局节。为了符合更严格的标准（如Windows的GetPrivateProfileStringAPI）和避免歧义，我的实现要求所有键值对必须位于某个明确的节定义之后。节定义之前的键值对会被忽略。
文件打开失败：如果文件不存在，Load()失败。这里的设计选择是：返回false，并清空内部数据。调用方可以检查返回值，如果为false且希望文件不存在时使用默认配置，可以随后调用一系列的SetValue来初始化默认值，最后调用Save()创建文件。

3.2 数据类型转换的实现

这是提升易用性的关键。以GetIntValue和SetIntValue为例：

int IniFile::GetIntValue(const std::string& section, const std::string& key, int default_value) { std::string str_val = GetStringValue(section, key, ""); if (str_val.empty()) { return default_value; } try { // 使用std::stoi，它能处理进制（如0x开头的十六进制） // 第二个参数size_t* idx用于指示转换停止的位置，第三个参数是进制基数，0表示自动检测 size_t pos; int val = std::stoi(str_val, &pos, 0); // 检查是否整个字符串都被成功转换了 if (pos == str_val.length()) { return val; } else { // 字符串只有部分被转换，说明格式可能有问题，返回默认值 return default_value; } } catch (const std::invalid_argument& e) { // 转换失败，例如字符串是“abc” return default_value; } catch (const std::out_of_range& e) { // 数字超出int范围 return default_value; } } void IniFile::SetIntValue(const std::string& section, const std::string& key, int value) { SetStringValue(section, key, std::to_string(value)); }

关键点与避坑指南：

异常安全：std::stoi,std::stod在转换失败时会抛出异常（std::invalid_argument或std::out_of_range）。务必使用try-catch块包裹，并在捕获异常时返回默认值。这是保证程序不会因为一个错误配置项而崩溃的关键。
完全转换检查：std::stoi的pos参数非常有用。如果字符串是“123abc”，std::stoi会转换前三个字符，pos会变成3。这通常不是我们想要的（用户可能输错了）。通过检查pos == str_val.length()，我们可以确保整个字符串都是一个有效的数字，否则返回默认值。
布尔值转换：GetBoolValue的实现需要更灵活。通常我们认为“1”,“true”,“yes”,“on”（不区分大小写）都表示true；“0”,“false”,“no”,“off”表示false。实现时需要将这些字符串统一转换为小写再比较。

3.3 数据存储与文件写入

数据存储在嵌套的std::map中：std::map<std::string, std::map<std::string, std::string>> m_data;。

Save()函数需要将这个结构体优雅地写回文件：

bool IniFile::Save(const std::string& filename) { std::string save_filename = filename.empty() ? m_filename : filename; std::ofstream outFile(save_filename); if (!outFile.is_open()) { return false; } // 为了保持输出顺序（map默认按键排序），我们可以直接遍历。 // 如果需要保持加载时的原始顺序，则需要更复杂的数据结构（如std::vector + std::unordered_map）。 for (const auto& section_pair : m_data) { const std::string& section_name = section_pair.first; const auto& key_value_map = section_pair.second; // 写入节头 outFile << "[" << section_name << "]" << std::endl; // 写入该节下的所有键值对 for (const auto& kv_pair : key_value_map) { outFile << kv_pair.first << "=" << kv_pair.second << std::endl; } // 节之间添加一个空行，提高可读性 outFile << std::endl; } outFile.close(); return true; }

关键点与避坑指南：

保存顺序：std::map会按照键（节名、键名）的字典序进行排序后输出。这可能导致保存的文件与加载时的原始顺序不同。如果顺序对你很重要（例如为了版本对比或人工阅读习惯），你需要改用std::vector<std::pair<...>>来保存顺序，并用std::unordered_map来提供快速查找。但这会增加实现的复杂性。对于大多数应用，排序输出是可接受的，甚至更整洁。
文件覆盖：std::ofstream默认会覆盖原文件。这正是我们想要的行为。如果保存失败（如磁盘已满、权限不足），函数返回false，原文件内容不会被破坏。
空节处理：如果一个节下面没有任何键值对，上面的代码仍然会输出[Section]和一个空行。这符合INI文件的常见表现。如果你认为空节是无效的，可以在写入节头前检查key_value_map是否为空。

4. 完整源码实现与注解

下面是将所有部分组合起来的完整IniFile类头文件和实现文件。代码包含了必要的注释和前面提到的最佳实践。

ini_file.h

#ifndef INI_FILE_H #define INI_FILE_H #include <string> #include <map> #include <vector> class IniFile { public: explicit IniFile(const std::string& filename); // 加载与保存 bool Load(); bool Save(const std::string& filename = ""); // 读取值（带默认值） std::string GetStringValue(const std::string& section, const std::string& key, const std::string& default_value = ""); int GetIntValue(const std::string& section, const std::string& key, int default_value = 0); double GetDoubleValue(const std::string& section, const std::string& key, double default_value = 0.0); bool GetBoolValue(const std::string& section, const std::string& key, bool default_value = false); // 设置值 void SetStringValue(const std::string& section, const std::string& key, const std::string& value); void SetIntValue(const std::string& section, const std::string& key, int value); void SetDoubleValue(const std::string& section, const std::string& key, double value); void SetBoolValue(const std::string& section, const std::string& key, bool value); // 工具函数 bool HasSection(const std::string& section) const; bool HasKey(const std::string& section, const std::string& key) const; void DeleteSection(const std::string& section); void DeleteKey(const std::string& section, const std::string& key); std::vector<std::string> GetSectionNames() const; std::vector<std::string> GetKeyNames(const std::string& section) const; // 获取关联的文件名 std::string GetFileName() const { return m_filename; } private: // 内部工具函数 static void Trim(std::string& str); static std::string ToLower(const std::string& str); std::string m_filename; // 使用嵌套map存储数据： section_name -> (key -> value) std::map<std::string, std::map<std::string, std::string>> m_data; }; #endif // INI_FILE_H

ini_file.cpp

#include “ini_file.h” #include <fstream> #include <sstream> #include <cctype> #include <algorithm> #include <stdexcept> using namespace std; IniFile::IniFile(const string& filename) : m_filename(filename) { // 构造函数里可以不加载，提供显式的Load方法更清晰 } bool IniFile::Load() { ifstream inFile(m_filename); if (!inFile.is_open()) { // 文件不存在或其他原因无法打开，清空数据并返回false m_data.clear(); return false; } m_data.clear(); string current_section; string line; while (getline(inFile, line)) { Trim(line); if (line.empty() || line[0] == ';' || line[0] == '#') { continue; } // 检查节头 if (line.front() == '[' && line.back() == ']') { current_section = line.substr(1, line.length() - 2); Trim(current_section); // 即使节名为空，也创建一个条目，但后续解析会忽略其下的键值对？这里选择创建。 // 更严格的做法是如果节名为空，则忽略该节定义。 if (!current_section.empty()) { m_data[current_section]; // 确保节存在，即使为空map } else { // 如果节名为空，将current_section置空，后续键值对无归属，将被忽略 current_section.clear(); } continue; } // 解析键值对 size_t eq_pos = line.find('='); if (eq_pos != string::npos) { string key = line.substr(0, eq_pos); string value = line.substr(eq_pos + 1); Trim(key); Trim(value); if (!key.empty() && !current_section.empty()) { m_data[current_section][key] = value; } // 如果current_section为空（即键值对在第一个节定义之前），则忽略此行 } // 没有‘=’的行，忽略 } inFile.close(); return true; } bool IniFile::Save(const string& filename) { string save_name = filename.empty() ? m_filename : filename; ofstream outFile(save_name); if (!outFile.is_open()) { return false; } bool first_section = true; for (const auto& section_pair : m_data) { if (section_pair.first.empty()) { continue; // 跳过空节名（如果有的话） } if (!first_section) { outFile << endl; // 节之间加空行 } first_section = false; outFile << "[" << section_pair.first << "]" << endl; for (const auto& kv_pair : section_pair.second) { outFile << kv_pair.first << "=" << kv_pair.second << endl; } } outFile.close(); return true; } // --- 字符串工具函数 --- void IniFile::Trim(string& str) { // 删除左边的空白字符 str.erase(str.begin(), find_if(str.begin(), str.end(), [](unsigned char ch) { return !isspace(ch); })); // 删除右边的空白字符 str.erase(find_if(str.rbegin(), str.rend(), [](unsigned char ch) { return !isspace(ch); }).base(), str.end()); } string IniFile::ToLower(const string& str) { string lower_str = str; transform(lower_str.begin(), lower_str.end(), lower_str.begin(), ::tolower); return lower_str; } // --- 值获取函数 --- string IniFile::GetStringValue(const string& section, const string& key, const string& default_value) { auto sec_it = m_data.find(section); if (sec_it != m_data.end()) { const auto& key_map = sec_it->second; auto key_it = key_map.find(key); if (key_it != key_map.end()) { return key_it->second; } } return default_value; } int IniFile::GetIntValue(const string& section, const string& key, int default_value) { string str_val = GetStringValue(section, key, ""); if (str_val.empty()) return default_value; try { size_t pos; int val = stoi(str_val, &pos, 0); // 支持十进制、十六进制(0x)、八进制(0) if (pos == str_val.length()) { return val; } } catch (const invalid_argument& e) { // 不是有效数字 } catch (const out_of_range& e) { // 数字超出范围 } return default_value; } double IniFile::GetDoubleValue(const string& section, const string& key, double default_value) { string str_val = GetStringValue(section, key, ""); if (str_val.empty()) return default_value; try { size_t pos; double val = stod(str_val, &pos); if (pos == str_val.length()) { return val; } } catch (const invalid_argument& e) { } catch (const out_of_range& e) { } return default_value; } bool IniFile::GetBoolValue(const string& section, const string& key, bool default_value) { string str_val = GetStringValue(section, key, ""); if (str_val.empty()) return default_value; str_val = ToLower(str_val); if (str_val == "1" || str_val == "true" || str_val == "yes" || str_val == "on") { return true; } else if (str_val == "0" || str_val == "false" || str_val == "no" || str_val == "off") { return false; } // 无法识别的字符串，返回默认值 return default_value; } // --- 值设置函数 --- void IniFile::SetStringValue(const string& section, const string& key, const string& value) { if (section.empty()) { // 根据我们的设计，不允许空节名 return; } m_data[section][key] = value; } void IniFile::SetIntValue(const string& section, const string& key, int value) { SetStringValue(section, key, to_string(value)); } void IniFile::SetDoubleValue(const string& section, const string& key, double value) { SetStringValue(section, key, to_string(value)); } void IniFile::SetBoolValue(const string& section, const string& key, bool value) { SetStringValue(section, key, value ? "true" : "false"); } // --- 工具函数 --- bool IniFile::HasSection(const string& section) const { return m_data.find(section) != m_data.end(); } bool IniFile::HasKey(const string& section, const string& key) const { auto sec_it = m_data.find(section); if (sec_it != m_data.end()) { return sec_it->second.find(key) != sec_it->second.end(); } return false; } void IniFile::DeleteSection(const string& section) { m_data.erase(section); } void IniFile::DeleteKey(const string& section, const string& key) { auto sec_it = m_data.find(section); if (sec_it != m_data.end()) { sec_it->second.erase(key); } } vector<string> IniFile::GetSectionNames() const { vector<string> sections; for (const auto& pair : m_data) { sections.push_back(pair.first); } return sections; } vector<string> IniFile::GetKeyNames(const string& section) const { vector<string> keys; auto sec_it = m_data.find(section); if (sec_it != m_data.end()) { for (const auto& pair : sec_it->second) { keys.push_back(pair.first); } } return keys; }

5. 使用示例与高级技巧

有了完整的类，使用起来就非常直观了。下面是一个简单的示例程序main.cpp：

#include “ini_file.h” #include <iostream> #include <vector> int main() { // 1. 创建IniFile对象并加载文件 IniFile config(“my_config.ini”); if (!config.Load()) { std::cout << “配置文件不存在，将使用默认配置并创建新文件。” << std::endl; // 初始化默认值 config.SetStringValue(“Database”, “Host”, “localhost”); config.SetIntValue(“Database”, “Port”, 3306); config.SetBoolValue(“Features”, “EnableLogging”, true); config.SetDoubleValue(“Physics”, “Gravity”, 9.81); config.Save(); // 保存默认配置到文件 } // 2. 读取配置 std::string db_host = config.GetStringValue(“Database”, “Host”, “127.0.0.1”); int db_port = config.GetIntValue(“Database”, “Port”, 3306); bool logging_enabled = config.GetBoolValue(“Features”, “EnableLogging”, false); double gravity = config.GetDoubleValue(“Physics”, “Gravity”, 9.8); std::cout << “Database Host: “ << db_host << std::endl; std::cout << “Database Port: “ << db_port << std::endl; std::cout << “Logging Enabled: “ << (logging_enabled ? “Yes” : “No”) << std::endl; std::cout << “Gravity Constant: “ << gravity << std::endl; // 3. 修改并保存配置 config.SetIntValue(“Database”, “Port”, 3366); config.SetStringValue(“User”, “Name”, “Alice”); if (config.Save()) { std::cout << “配置已更新并保存。” << std::endl; } // 4. 遍历所有节和键 std::vector<std::string> sections = config.GetSectionNames(); for (const auto& sec : sections) { std::cout << “[“ << sec << “]” << std::endl; std::vector<std::string> keys = config.GetKeyNames(sec); for (const auto& key : keys) { std::string val = config.GetStringValue(sec, key); std::cout << “ “ << key << “ = “ << val << std::endl; } } return 0; }

编译与运行：使用g++或你喜欢的C++编译器进行编译：

g++ -std=c++11 -o ini_demo main.cpp ini_file.cpp ./ini_demo

高级技巧与扩展思路：

线程安全：当前的IniFile类不是线程安全的。如果需要在多线程环境中使用，一个简单的方法是在调用类方法的上一层加锁。更优雅的做法是在类内部使用std::mutex，在每个会修改内部数据（Load,Save,SetValue,Delete）和读取数据（GetValue,HasKey）的公共方法里加锁。注意，这可能会成为性能瓶颈，但对于配置读写这种低频操作，通常可以接受。
值变更通知（观察者模式）：在大型项目中，可能希望当某个配置项改变时，自动通知相关的模块。可以在SetValue方法内部维护一个观察者列表，当值真正发生变化时，调用注册的回调函数。这会使类变得复杂，但解耦了配置管理和业务逻辑。
支持节/键的注释：在内存中存储注释是很困难的，因为注释与节/键的关联性在解析后丢失了。一个高级的实现可能会用一个结构体来存储每个条目（键值对），结构体里包含值字符串和它上方的注释字符串。在保存时，将注释写回。这需要完全重写内部存储结构。
默认节：可以定义一个特殊的节名（如“DEFAULT”或空字符串“”）。当在指定节中找不到键时，可以回退到默认节中查找。这需要修改GetValue系列函数的逻辑。
文件监控：可以启动一个后台线程，使用平台特定的API（如inotifyon Linux,ReadDirectoryChangesWon Windows）来监控配置文件的变化，并在文件被外部修改时自动重新加载。这非常适合需要热重载配置的场景。

6. 常见问题排查与性能考量

在实际使用中，你可能会遇到一些问题。这里列出一些典型场景和排查思路。

问题1：读取的数值总是默认值，但配置文件里明明有。

可能原因1：节名或键名大小写或空格不匹配。INI解析通常是大小写敏感的，且Trim函数可能没有正确工作。检查你的Trim函数实现，并确保在代码中使用的节/键名与文件中的完全一致（包括大小写）。
可能原因2：键值对写在节定义之前。根据我们的实现，节定义之前的键值对会被忽略。确保所有Key=Value都在[Section]之后。
可能原因3：值包含空格且未用引号包裹。对于Key = value with spaces，我们的解析器会得到key为“Key “，value为“ value with spaces”。Trim后，key变成“Key”，value变成“value with spaces”，这是正确的。但如果值是“value with = inside”，我们的简单解析器会在第一个=处分割，导致错误。复杂的值建议避免使用特殊字符，或考虑使用其他格式（如JSON）。

问题2：保存文件后，中文或其他非ASCII字符变成乱码。

原因：文件读写时的编码不一致。Windows记事本默认使用ANSI（如GBK）编码保存，而你的C++程序可能以UTF-8（无BOM）方式读取和写入。
解决方案：
- 统一编码：确保你的源代码文件、配置文件、程序读写都使用同一种编码，推荐UTF-8 without BOM。
- 宽字符版本：在Windows上，可以使用std::wifstream/std::wofstream并与std::wstring配合，同时使用std::locale设置全局编码（如std::locale::global(std::locale(“.65001”))用于UTF-8）。但这会大幅增加代码复杂性。
- 实用建议：对于简单的配置，尽量避免在INI文件中直接使用非ASCII字符。如果必须使用，明确团队内使用的编码规范，并在代码注释中写明。

问题3：程序运行时修改了INI文件，但程序没有感知到新配置。

原因：Load()只在启动时调用了一次，后续配置被缓存在内存的m_data中。
解决方案：实现一个Reload()方法，重新读取文件并更新m_data。可以在固定的时间间隔、收到特定信号（如SIGHUP）或用户请求时调用它。注意，重载时需要考虑线程安全。

性能考量：

解析性能：对于大小在KB级别的配置文件，使用std::getline逐行解析和std::map存储，性能完全不是问题。即使是上万行的配置，加载也在一瞬间完成。
内存占用：使用std::map存储字符串，会有些内存开销。但对于配置数据来说，这点开销微乎其微。
查找性能：std::map的查找是O(log n)。对于配置访问，这足够快。如果配置文件极大（几十万条），且需要极高频的查找，可以考虑改用std::unordered_map（平均O(1)），但会失去排序特性，且自定义键类型需要提供哈希函数。

一个我踩过的坑：关于“原地修改”早期我的Save方法实现中，没有使用临时变量save_filename，而是直接修改m_filename。这导致了一个问题：如果用户调用Save(“backup.ini”)保存了一个副本，那么后续再调用无参数的Save()时，就会错误地保存到backup.ini，而不是原始文件。因此，在Save函数中，永远不要修改m_filename，除非这是类的明确设计意图（即“另存为”后，对象就绑定到新文件）。当前的实现是安全的：Save()使用传入的文件名，若为空则用m_filename，但m_filename始终保持不变。