logging 的基本用法網(wǎng)上很多，這里就不介紹了。在引入正文之前，先來(lái)看一個(gè)需求：

假設(shè)需要將某功能封裝成類(lèi)庫(kù)供他人使用，如何處理類(lèi)庫(kù)中的日志？

數(shù)年前在一個(gè) C# 開(kāi)發(fā)的項(xiàng)目中，我用了這樣的方法：定義一個(gè) logging 基類(lèi)，所有需要用到日志的類(lèi)都繼承這個(gè)基類(lèi)，這個(gè)基類(lèi)中定義一個(gè) LogHandler 事件，該事件用于實(shí)現(xiàn)具體的記錄日志動(dòng)作，同時(shí)可以通過(guò)將類(lèi) A 的 LogHandler 委托掛到類(lèi) B 的 LogHandler 上，實(shí)現(xiàn)將兩個(gè)類(lèi)的日志信息添加到一起。

自從看了 python 中 logging 的實(shí)現(xiàn)方式，我發(fā)現(xiàn)我的做法真是弱爆了。

我在之前的博客 Python：logging.NullHandler 的使用 中介紹了 peewee 框架中的日志輸出，簡(jiǎn)單來(lái)說(shuō)就是 peewee 中定義了一個(gè)名為peewee 的 Logger 并添加了一個(gè) NullHandler，調(diào)用者只需要為其添加具體的 Handler 就可以輸出日志了，非常方便。

假設(shè)我們?cè)谥鞒绦蛑幸灿幸粋€(gè) Logger，調(diào)用 peewee 后，我想將兩個(gè)日志輸出到同一個(gè)日志文件中去。顯然將兩個(gè)日志的 FileHandler 指向同一個(gè)日志文件是不可取的，存在并發(fā)搶占文件的風(fēng)險(xiǎn)。當(dāng)然我們也可以將主程序中的 Logger 名字定為 peewee，但這不僅太 low 了，而且如果再調(diào)用一個(gè)庫(kù)，其中也封裝好了一個(gè) Logger，就不好處理了。

樹(shù)樁結(jié)構(gòu)的 Logger

Logger 對(duì)象被設(shè)計(jì)為一個(gè)樹(shù)形結(jié)構(gòu)，它有一個(gè) parent 屬性。logging 中定義了一個(gè)名為 root 的 Logger 作為所有 Logger 的根節(jié)點(diǎn)，root 的 parent 屬性為 None。root 是全局的。

當(dāng)調(diào)用

            
logging.getLogger(name=None)
          

得到一個(gè) Logger 對(duì)象的時(shí)候，如果 name 為 None，則返回根節(jié)點(diǎn) root。如果 name 中含有 .，比如 name = 'a.b'，這時(shí)如果已經(jīng)存在了名為 a 的 Logger，則 a.b 為 a 的子節(jié)點(diǎn)，如果不存在名為 a 的 Logger，則 a.b 為 root 的子節(jié)點(diǎn)。

child logger 在完成對(duì)日志消息的處理后，默認(rèn)會(huì)將日志消息傳遞給與它的 parent logger。因此，我們不必為一個(gè)應(yīng)用程序中使用的所有 Logger 定義和配置 handlers，只需要為一個(gè)頂層的 Logger 配置 handlers，然后按照需要?jiǎng)?chuàng)建 child loggers 就可足夠了。我們可以通過(guò)設(shè)置 Logger 的 propagate 屬性設(shè)置為 False 來(lái)關(guān)閉這種傳遞機(jī)制。

什么意思呢，我們來(lái)看代碼：

            
import logging
logA = logging.getLogger('a')
logA.setLevel(logging.DEBUG)
logA.addHandler(logging.StreamHandler())
logB = logging.getLogger('a.b')
logB.addHandler(logging.StreamHandler())
          

輸出結(jié)果：

            
Logger A
Logger B
Logger B
          

之所以 Logger B 被輸出了 2 次，是因?yàn)?logB 是 logA 的子節(jié)點(diǎn)，并且 logB 中也定義了 Handler，所以 logB 的 Handler 輸出了一次，logA 的 Handler 也輸出了一次，就 2 次了。如果想只輸出一次，可以刪掉 logB 中的 Handler。當(dāng)然，這也是有用處的，尤其是當(dāng)你手頭沒(méi)有日志管理工具的時(shí)候。例如，主程序中需要輸出所有的日志，以便了解程序整體的運(yùn)行順序，而某模塊的日志，你想單獨(dú)輸出一份，以便清晰了解模塊中的報(bào)錯(cuò)或者是執(zhí)行順序。

之前 peewee 的例子也就很容易解決了，只需要將 peewee 日志的 parent 屬性設(shè)置為主程序的日志就可以了。

結(jié)語(yǔ)

其實(shí)這是一個(gè)比較容易說(shuō)明的問(wèn)題，完全沒(méi)必要寫(xiě)這么多。我并不想跟大家分享 python 中的 logging 是怎么用的，而是想和大家分享 logging 如此實(shí)現(xiàn)的一種思想，因?yàn)槲矣龅竭^(guò)這個(gè)問(wèn)題，也設(shè)計(jì)了解決方案，然后被完爆了。