C语言实战：从零开始编写一个通用配置文件解析器

资料合集下载链接：

​https://pan.quark.cn/s/472bbdfcd014​

在软件开发中，我们经常需要将一些可变的参数（如数据库地址、端口号、游戏角色属性等）与代码本身分离，方便日后修改而无需重新编译整个程序。这种存储配置信息的文件，我们称之为配置文件。

一、 什么是配置文件？—— 键值对的艺术

配置文件本质上是一个纯文本文件，它遵循特定的格式来存储信息。最常见、最直观的格式就是“键值对”（Key-Value Pair）。

• • 键 (Key): 也叫“索引”或“属性名”，用于唯一标识一个配置项。
• • 值 (Value): 与键对应的数据。

让我们来看一个具体的例子，创建一个名为 ​​hero.conf​​ 的文件：

​​hero.conf​​ 文件内容

# 英雄的基本信息配置
# 这是一个注释行，解析时应该被忽略HeroID = 101
HeroName = 盖伦
Attack = 95
Defense = 88# 英雄的背景故事，可以包含空格
Info = 一位来自德玛西亚的勇士，为了正义而战。

格式说明：

1. 1. 键值对： ​​HeroName = 盖伦​​ 就是一个键值对，​​HeroName​​是键，​​盖伦​​是值，它们之间用 ​​=​​ 分隔。
2. 2. 注释： 以 ​​#​​ 开头的行是注释，程序在解析时应当忽略它们。
3. 3. 空行： 文件中的空行也应该被忽略。

我们的目标就是编写一个程序，能够读取这个文件，并能根据一个“键”（如 "HeroName"）快速查找到对应的“值”（"盖伦"）。

二、 数据结构设计：如何安放我们的键值对？

要将文件中的数据加载到内存中，我们首先需要一个合适的数据结构来存放每一对键值。根据笔记的提示，一个结构体是完美的选择。

代码案例 1：设计 ​​​ConfigInfo​​ 结构体

#include <stdio.h>#define MAX_SIZE 64 // 定义键和值的最大长度// 使用 typedef 方便后续使用
typedef struct {char key[MAX_SIZE];char value[MAX_SIZE];
} ConfigInfo;

这个 ​​ConfigInfo​​ 结构体非常直观，它包含两个字符数组成员：​​key​​ 和 ​​value​​，分别用于存储从配置文件中解析出来的键和值。​​MAX_SIZE​​ 宏定义了它们的最大长度，这里我们设置为64个字符，足以应对大多数场景。

三、 文件解析流程：两步走，稳准狠！

直接读取并解析文件可能会有些混乱。一个更清晰、更健壮的方法是采用“两步解析法”（Two-Pass Approach）：

1. 1. 第一遍扫描 (Pass 1): 遍历整个文件，只做一件事——统计有效配置项的数量。这样我们就能精确地知道需要分配多大的内存空间。
2. 2. 第二遍扫描 (Pass 2): 再次从头读取文件，这次真正地解析每一行，将键值对填充到我们已经