單片機項目在很多時候都需要調試，通過日志診斷bug是常見的一種調試方法。

下面就給大家分享一個開源的適合單片機的輕量級日志庫，只有log.c 和 log.h 兩個文件，使用非常方便。

用法

這個日志庫的使用比較簡單，新手完全可以勝任。

1、概述

在你的項目中添加log.c 和 log.h 文件。

提供 6 用于日志記錄的類似函數的宏：

log_trace(const char *fmt, ...);
log_debug(const char *fmt, ...);
log_info(const char *fmt, ...);
log_warn(const char *fmt, ...);
log_error(const char *fmt, ...);
log_fatal(const char *fmt, ...);

每個函數都采用一個 printf 格式字符串，后跟其他參數：

log_trace("Hello %s", "world")

生成一行給定格式的行打印到 stderr：

2026TRACEsrc/main.cHelloworld

2、接口描述

log_set_quiet(bool enable)

可以通過傳遞給函數來啟用Quiet安靜模式（不輸入日志）。

啟用此模式時，庫不會向輸出任何內容，但是將繼續寫入文件和回調（如果已設置）。truelog_set_quiet()stderr

log_set_level(int level)

可以使用該函數設置當前日志記錄級別。不會將低于給定級別的所有日志寫入 。默認情況下級別為LOG_TRACE, ，即不忽略任何內容。log_set_level()stderrLOG_TRACE

log_add_fp(FILE *fp, int level)

可以將一個或多個將寫入日志的文件指針提供給庫，通過使用函數。寫入文件的數據輸出采用以下格式：log_add_fp()

2047-03-11 2026 TRACE src/main.c Hello world

給定值以下的任何消息都將被忽略。如果庫無法添加文件指針返回小于零的值。

log_add_callback(log_LogFn fn, void *udata, int level)

使用日志數據調用的一個或多個回調函數可以是 通過使用函數提供給庫。回調 函數傳遞一個包含數字、、字符串、printf va_list和給定 .log_add_callback()log_Eventlinefilenamefmtvaleveludata

log_set_lock（log_LockFn fn， void *udata）

如果日志將從多個線程寫入，則可以設置鎖定函數。如果應該獲取鎖，或者是否應該釋放鎖并給定值，則該函數將傳遞布爾值。truefalseudata

const char* log_level_string(int level)

以字符串形式返回給定日志級別的名稱。

LOG_USE_COLOR

如果使用-DLOG_USE_COLOR編譯庫，則在打印時將使用ANSI轉義碼。

開源協議

該庫為免費軟件庫，但你需要對應的 MIT 許可證條款。

開源地址：

https://github.com/rxi/log.c

審核編輯：湯梓紅