配置文件怎么写？新手入门教程详解

在 C 语言中处理配置文件通常有以下几种方法，下面我将介绍两种主流方案,并提供完整示例代码：

方案 1：使用 INI 格式配置文件（轻量级推荐）

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <ctype.h>
#define MAX_LINE_LENGTH 256
#define MAX_KEY_LENGTH 50
#define MAX_VALUE_LENGTH 100
// 配置结构体
typedef struct {
    char server_ip[MAX_VALUE_LENGTH];
    int port;
    int debug_mode;
    float timeout;
} Config;
// 去除字符串两端空白
void trim(char *str) {
    char *end;
    while(isspace((unsigned char)*str)) str++;
    if(*str == 0) return;
    end = str + strlen(str) - 1;
    while(end > str && isspace((unsigned char)*end)) end--;
    *(end+1) = 0;
}
// 解析配置文件
int parse_config(const char *filename, Config *config) {
    FILE *file = fopen(filename, "r");
    if (!file) {
        perror("Error opening file");
        return 0;
    }
    char line[MAX_LINE_LENGTH];
    char key[MAX_KEY_LENGTH];
    char value[MAX_VALUE_LENGTH];
    while (fgets(line, sizeof(line), file)) {
        // 跳过注释和空行
        if (line[0] == '#' || line[0] == 'n' || line[0] == ';') 
            continue;
        // 分割键值对
        if (sscanf(line, "%[^=]=%s", key, value) == 2) {
            trim(key);
            trim(value);
            // 处理不同配置项
            if (strcmp(key, "server_ip") == 0) {
                strncpy(config->server_ip, value, sizeof(config->server_ip));
            } 
            else if (strcmp(key, "port") == 0) {
                config->port = atoi(value);
            } 
            else if (strcmp(key, "debug_mode") == 0) {
                config->debug_mode = (strcasecmp(value, "true") == 0) ? 1 : 0;
            } 
            else if (strcmp(key, "timeout") == 0) {
                config->timeout = atof(value);
            }
        }
    }
    fclose(file);
    return 1;
}
int main() {
    Config my_config = {
        .server_ip = "127.0.0.1",  // 默认值
        .port = 8080,
        .debug_mode = 0,
        .timeout = 5.0
    };
    if (parse_config("config.ini", &my_config)) {
        printf("Loaded configuration:n");
        printf("Server IP: %sn", my_config.server_ip);
        printf("Port: %dn", my_config.port);
        printf("Debug Mode: %sn", my_config.debug_mode ? "ON" : "OFF");
        printf("Timeout: %.1f secondsn", my_config.timeout);
    } else {
        printf("Using default configurationn");
    }
    return 0;
}

示例配置文件 config.ini:

# 服务器配置
server_ip = 192.168.1.100
port = 8080
# 调试设置
debug_mode = true
# 超时设置 (秒)
timeout = 3.5

方案 2：使用 JSON 格式（需要第三方库 cJSON）

#include <stdio.h>
#include "cJSON.h" // 需要 cJSON 库
typedef struct {
    char server_ip[16];
    int port;
    int debug_mode;
    double timeout;
} Config;
int parse_json_config(const char *filename, Config *config) {
    FILE *file = fopen(filename, "r");
    if (!file) return 0;
    fseek(file, 0, SEEK_END);
    long size = ftell(file);
    fseek(file, 0, SEEK_SET);
    char *json_data = malloc(size + 1);
    fread(json_data, 1, size, file);
    fclose(file);
    json_data[size] = 0;
    cJSON *root = cJSON_Parse(json_data);
    if (!root) {
        free(json_data);
        return 0;
    }
    cJSON *item;
    if ((item = cJSON_GetObjectItem(root, "server_ip"))) 
        strncpy(config->server_ip, item->valuestring, sizeof(config->server_ip));
    if ((item = cJSON_GetObjectItem(root, "port"))) 
        config->port = item->valueint;
    if ((item = cJSON_GetObjectItem(root, "debug_mode"))) 
        config->debug_mode = cJSON_IsTrue(item);
    if ((item = cJSON_GetObjectItem(root, "timeout"))) 
        config->timeout = item->valuedouble;
    cJSON_Delete(root);
    free(json_data);
    return 1;
}

最佳实践建议：

1. 格式选择：

   • 简单配置：INI 格式（轻量无需依赖）
   • 复杂配置：JSON/XML（需要第三方库）
   • 系统级配置：考虑 libconfig 库

2. 安全注意事项：

   

   • 始终验证输入数据
   • 使用 strncpy 代替 strcpy
   • 检查数值范围（如端口号 0-65535）
   • 处理文件不存在的情况

3. 错误处理：

   • 提供默认值
   • 详细的错误日志
   • 配置文件版本兼容性检查

4. 高级方案：

   // 使用 libconfig 库示例
   #include <libconfig.h>
   config_init(&cfg);
   if (!config_read_file(&cfg, "app.cfg")) {
       fprintf(stderr, "%s:%d - %sn",
           config_error_file(&cfg),
           config_error_line(&cfg),
           config_error_text(&cfg));
       config_destroy(&cfg);
       exit(EXIT_FAILURE);
   }
   config_lookup_int(&cfg, "port", &port);
   config_lookup_string(&cfg, "server_ip", &ip_str);

配置文件设计原则：

1. 使用分组组织相关设置
2. 添加注释说明每个配置项
3. 包含版本信息
4. 支持环境变量覆盖（如 ${HOME}）
5. 提供配置验证工具

根据项目需求选择合适方案，小型项目推荐 INI 格式，企业级应用建议使用 libconfig 或类似的成熟配置库。