C语言手动生成XML文件的简易实现方案

夏知夏

发布时间：2026-10-14| 3人浏览过

原创

在嵌入式开发或轻量级服务中，有时需要直接输出XML格式的配置或日志，而不希望引入庞大的解析库。本方案通过在C语言中封装简单的文件写入函数，利用fprintf动态构建XML结构，支持自动缩进和基本的节点闭合，实现零依赖的XML生成。

实现原理与逻辑结构

C语言标准库提供了基础的stdio.h文件操作能力。生成XML的本质是将符合语法的字符串序列写入文件。为了保证输出的可读性，通常需要维护一个全局的缩进计数器tabs，并在每次开启新节点时递增，关闭时递减。核心功能模块包括：

输出流管理：绑定目标文件指针。
基础字符写入：用于转义或拼接特殊符号（如<, >）。
节点控制：tag_start处理开始标签，tag_end处理闭合标签。
值写入：tag_value处理带属性的自闭合标签，tag_value_num处理整型值。

代码环境与前置准备

该实现依赖标准的ANSI C环境，无需额外编译参数或链接库。需注意以下几点：

编码设置：代码示例中硬编码了GBK编码声明，生产环境中请根据目标系统调整为UTF-8或其他必要编码，并确保文件保存时采用相同编码。
安全性：此方案为简例，未包含XML特殊字符转义（如将&转为&），若输入内容不可控，需自行添加转义逻辑以防破坏XML结构。

第1步：定义全局状态与基础IO函数

首先定义静态变量来保存文件指针和当前的缩进层级，以及辅助函数用于统一写入逻辑。

#include <stdio.h>

static FILE *out = NULL;
static int tabs = 0;

// 设置输出文件指针
void set_out_fp(FILE *fp)
{
    out = fp;
}

// 通用字符写入封装
void put(char *str)
{
    fprintf(out, "%s", str);
}

第2步：处理XML头与缩进控制

XML文件通常以声明头开始。此外，需要一个循环来根据当前层级tabs打印对应的制表符，保持文档树状结构的视觉对齐。

// 写入XML头部声明
void put_head(char *head)
{
    put("<?");
    put(head); // 例如: xml version='1.0' encoding="UTF-8"
    put("?>\n");
}

// 根据层级输出制表符
void out_tabs()
{
    int i;
    for(i=0; i < tabs; i++)
    {
        put("\t");
    }
}

第3步：实现节点开闭与值的写入逻辑

这是核心部分。开标签增加层级，关标签减少层级。对于包含属性值的标签，采用自闭合标签形式<tag value="..."/>以便快速输出数据。

// 开启新节点
void tag_start(char *tag)
{
    out_tabs();
    put("<");
    put(tag);
    put(">\n");
    tabs = tabs + 1;
}

// 闭合当前节点
void tag_end(char *tag)
{
    tabs = tabs - 1;
    out_tabs();
    put("</");
    put(tag);
    put(">\n");
}

// 写入字符串属性值的自闭合标签
void tag_value(char *tag, char *value)
{
    out_tabs();
    put("<");
    put(tag);
    put(" value=\"");
    put(value);
    put("\" />\n");
}

// 写入整型值的自闭合标签
void tag_value_num(char *tag, long value)
{
    out_tabs();
    put("<");
    put(tag);
    put(" value=");
    fprintf(out, "%d", value);
    put(" />\n");
}

第4步：组合使用与文件保存

在main函数中，通过调用上述API构建具体的XML结构。示例构建了一个硬件信息的片段，最后务必关闭文件指针以刷新缓冲区。

int main()
{
    // 打开文件，此处以只写模式为例，实际可使用 fopen("output.xml", "w")
    // fdopen(1, "a") 将 stdout 关联，实际项目中建议指向具体文件路径
    FILE *fp = fopen("output.xml", "w"); 
    if(fp == NULL) return 1;
    
    set_out_fp(fp);

    // 1. 写入头信息
    put_head("xml version='1.0' encoding=\"GBK\"");
    
    // 2. 开始根节点
    tag_start("投递信息");
    
    // 3. 嵌套子节点
    tag_start("硬件");
    
    // 4. 写入具体属性值
    tag_value_num("网卡", 1);
    
    // 5. 闭合节点
    tag_end("硬件");
    tag_end("投递信息");

    // 6. 释放资源
    fclose(fp);

    return 0;
}