【开源分享】EasyLogger，一款超轻量级(ROM＜1.6K, RAM＜0.3K)、高性能的 C/C++ 日志库

最新推荐文章于 2025-05-11 07:00:00 发布

智驾

最新推荐文章于 2025-05-11 07:00:00 发布

阅读量1k

点赞数 11

分类专栏：开源分享文章标签：开源 c语言嵌入式 log EasyLogger

本文链接：https://blog.csdn.net/Allen_Spring/article/details/146006585

版权

开源分享专栏收录该内容

10 篇文章

订阅专栏

请添加图片描述

文章目录

深入解析EasyLogger：一款专为资源敏感场景设计的轻量级日志库
- 1. 简介
2. 核心特性
3. 使用示例
4. 与其他日志库的对比
5. 适用场景与开发建议
- 1. 适用场景
- 2. 开发建议
总结
参考

深入解析EasyLogger：一款专为资源敏感场景设计的轻量级日志库

1. 简介

EasyLogger 是一款专为资源敏感场景设计的超轻量级、高性能 C/C++ 日志库，适用于 IoT 设备、可穿戴设备、智能家居等嵌入式开发领域。其核心优势在于极低的资源占用（ROM <1.6K，RAM <0.3K）和高扩展性，同时支持多平台运行，包括裸机、RT-Thread、Linux、Windows 等。相比于传统日志库（如 zlog、log4cpp），EasyLogger 以简洁的接口和灵活的插件机制著称，开发者可快速上手并定制功能。

2. 核心特性

1. 轻量化与高性能

EasyLogger 的设计目标是在保证功能完整性的前提下，最小化资源消耗。其代码体积和内存占用极低，适合嵌入式设备或对性能要求严格的场景。例如，在 STM32 等微控制器上，仅需少量移植代码即可运行。

2. 多平台兼容性

支持多种操作系统（如 RT-Thread、UCOS、Linux、Windows）及裸机环境。开发者无需修改核心代码即可跨平台移植，显著降低开发成本。

3. 灵活的日志输出

多输出方式：支持终端、文件、串口、Flash 等多种输出目标，用户可通过插件扩展自定义输出方式（如数据库或网络）。
格式化与颜色显示：日志内容可包含级别、时间戳、线程/进程信息等，并支持不同级别日志的颜色区分，提升可读性。
异步与缓冲输出：通过异步输出模式避免日志写入阻塞主线程，缓冲输出模式则进一步优化性能。

4. 动态过滤与分级控制

多级日志：提供从 Assert（最高）到 Verbose（最低）共 6 个日志级别，支持静态（编译时）和动态（运行时）级别控制。
过滤机制：可按标签、关键词或级别动态过滤日志，快速定位问题。

5. 插件化扩展

EasyLogger 的核心功能可通过插件扩展，例如：

Flash 插件：无需文件系统，直接将日志存储到 Flash 中。
File 插件：支持日志文件循环保存、按大小或时间转档。

3. 使用示例

1. 移植与初始化

在项目中集成 EasyLogger 需完成以下步骤：

源码添加：将核心文件（如 elog.c、elog_utils.c）和移植接口文件（elog_port.c）加入工程。
接口实现：重写输出函数（如串口打印）和锁机制（确保多线程安全）。

// 初始化示例
ElogErrCode elog_init(void);
void elog_start(void);

2. 日志输出

EasyLogger 提供简化的宏接口，支持标签分类和分级输出：

#define LOG_TAG "wifi.module"
log_e("Connection failed: %d", error_code);  // 错误级别日志
log_d("Received data: %s", buffer);          // 调试级别日志

3. 配置与优化

格式设置：通过 elog_set_fmt 配置日志头信息（如时间、标签、行号）。
性能调优：启用异步模式减少主线程阻塞，或使用缓冲模式批量写入。

4. 与其他日志库的对比

特性	EasyLogger	zlog	spdlog
语言支持	C/C++	C	C++11+
资源占用	极低（ROM<1.6K）	中等	较高
多线程安全	支持（内置锁机制）	部分场景不稳定1	支持
跨平台性广泛（含裸机）	依赖 POSIX	依赖 C++标准库