最轻量兼容方案是调用kernel32.dll的Win32 API函数，因其无需依赖、跨.NET版本稳定；而Microsoft.VisualBasic.FileIO在.NET 6+中受限且封装隐藏关键细节，原生P/Invoke更可控透明。
IniHelper 工具类在 C# 中不是 .NET 原生组件，必须手动封装或引用外部库。Windows 平台下最轻量、最兼容的方案是调用 kernel32.dll 的 WritePrivateProfileString 和 GetPrivateProfileString —— 它们是 Windows API 原生支持的 INI 操作函数，无需额外依赖，也不依赖 .NET 版本。
为什么不用 Microsoft.VisualBasic.FileIO？
虽然 Microsoft.VisualBasic.FileIO 提供了 IniParser 类（如 ReadKeyValue），但它本质仍是 P/Invoke 封装，且只在部分 .NET Framework 版本中稳定；.NET 6+ 的跨平台项目中该命名空间默认不可用，DllImport 方式反而更可控、更透明。
-
Microsoft.VisualBasic在 .NET Core/.NET 5+ 中需显式安装 NuGet 包Microsoft.VisualBasic.Core，且部分方法已被标记为“不推荐用于新项目” - 其内部实现仍调用同一组 Win32 API，但封装层隐藏了错误码、缓冲区大小、编码等关键细节，出问题时难定位
- 例如：读取含中文的值时若未指定 ANSI/UTF-8 编码行为，
IniParser可能静默截断或乱码，而原生GetPrivateProfileString明确要求传入StringBuilder和size，强制你考虑长度边界
GetPrivateProfileString 返回值和缓冲区陷阱
这个函数返回的是实际写入 StringBuilder 的字符数（不含结尾 \0），不是成功/失败标志。常见误判是把返回值 == 0 当作“键不存在”，其实它也可能是“值为空字符串”或“缓冲区太小被截断”。
- 务必初始化
StringBuilder容量 ≥ 期待最大长度（建议至少 1024） - 检查返回值是否等于
capacity - 1：若是，说明值被截断，需重试更大缓冲区 - 若返回
0，应再调用一次，把def参数设为唯一哨兵值（如"__INI_KEY_NOT_FOUND__"），再比对结果，才能区分“空值”和“键不存在” - Windows 默认按系统 ANSI 编码读写（非 UTF-8），若 INI 文件用 UTF-8 保存，中文会乱码 —— 此时必须改用自解析方案（见下一条）
纯托管方案：IniFile 类需自己处理编码和节结构
当项目需跨平台（Linux/macOS）或强制 UTF-8 支持时，kernel32 API 不可用，必须手写解析器。此时不要用正则暴力匹配，而应逐行扫描、状态机驱动：
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 跳过以
;开头的注释行 - 遇到
[SectionName]时更新当前节名，注意去除首尾空格和方括号 - 遇到
Key = Value形式时，用IndexOf('=')找第一个等号，左侧 trim 后为 key，右侧从等号后开始 trim 为 value（保留等号右边的空格，因为那是值的一部分） - 写入时必须确保：节名独占一行、键值对顶格、无 BOM；否则某些旧版工具（如 Windows 记事本）可能显示异常
- 示例关键逻辑：
string[] lines = File.ReadAllLines(filePath, Encoding.UTF8);
—— 必须显式指定Encoding.UTF8，否则默认用系统编码，Win11 中文环境是 GB18030，和多数编辑器保存的 UTF-8 不兼容
WritePrivateProfileString 的三个 null 参数清空行为
这是最易被忽略的“隐藏功能”：当传入 null 或空字符串作为参数时，API 有特定语义：
-
WritePrivateProfileString("Section", null, null, path)→ 删除整个[Section]及其所有键值对 -
WritePrivateProfileString(null, null, null, path)→ 删除文件中所有节（清空整个 INI） -
WritePrivateProfileString("Section", "Key", "", path)→ 将Key的值设为空字符串（保留该键，只是值为空） - 注意：这些操作不会报错，也不会返回失败码，但要求路径可写；若文件被其他进程占用，写入静默失败（无异常），后续读不到变更
INI 文件看似简单，但 Win32 API 的隐式编码、缓冲区管理、null 语义和跨平台断层，让它在真实项目里很容易变成“改完配置不生效”的黑盒。别迷信“封装好就万事大吉”，每个 WritePrivateProfileString 调用前，都该确认路径存在、权限足够、编码一致、缓冲区够大。
