libConfuse 配置庫使用指南：從編譯到移植的完整流程

libConfuse：輕量級 C 語言配置文件解析庫

libConfuse 是一個 ISC 授權的開源庫，支持 Section、多種數據類型、嵌套 Include、環境變量展開等特性，API 簡單易用，適合嵌入式與桌面應用統一配置管理。

核心特性

• 支持類型：字符串、整數、浮點數、布爾值、列表
• 語法豐富：單/雙引號、環境變量 ${VAR}、嵌套 Include
• 跨平台：Linux、Windows、嵌入式 Linux 均可編譯運行

獲取與編譯（v2.7 為例）

# 下載
wget https://www.nongnu.org/confuse/confuse-2.7.tar.gz
tar xf confuse-2.7.tar.gz
cd confuse-2.7

# 配置並編譯庫
./configure
make -C src

# 編譯示例
make -C examples
./examples/simple  # 運行測試

移植到項目（源碼集成模式）

1. 創建項目內 confuse/ 目錄
2. 拷貝核心文件：config.h、src/confuse.c、src/confuse.h、src/lexer.c
3. 修改 config.h：註釋 #define ENABLE_NLS 1（若編譯報錯）
4. 修改 confuse.c：#include <config.h> → #include "config.h"
5. 編寫項目 Makefile 鏈接上述源文件

配置文件示例（app.cfg）

server {
    host = "192.168.1.100"
    port = 8080
    enable_ssl = true
}

database {
    path = "/var/lib/app/data.db"
    max_connections = 50
}

API 核心調用流程

cfg_opt_t opts[] = {
    CFG_SIMPLE_STR("host"),
    CFG_SIMPLE_INT("port"),
    CFG_SIMPLE_BOOL("enable_ssl"),
    CFG_END()
};

cfg_t *cfg = cfg_parse("app.cfg", opts);
const char *host = cfg_getstr(cfg, "server.host");
int port = cfg_getint(cfg, "server.port");
// 修改後寫回
cfg_setstr(cfg, "server.host", "10.0.0.1");
cfg_write(cfg, "app.cfg");
cfg_free(cfg);

性能測試數據

顯著優於 XML 解析方案，適合資源受限設備。

資源鏈接

• 官網：https://www.nongnu.org/confuse/
• GitHub：https://github.com/martinh/libconfuse