什么是context.Context？

context.Context是Golang標(biāo)準(zhǔn)庫提供的接口（context包對此接口有多種實現(xiàn)），該接口提供了四個抽象法：

成都創(chuàng)新互聯(lián)公司專注網(wǎng)站設(shè)計,以設(shè)計驅(qū)動企業(yè)價值的持續(xù)增長,網(wǎng)站，看似簡單卻每一個企業(yè)都需要——設(shè)計，看似簡潔卻是每一位設(shè)計師的心血 10年來，我們只專注做網(wǎng)站。認(rèn)真對待每一個客戶，我們不用口頭的語言來吹擂我們的優(yōu)秀，超過千家的成功案例見證著我們的成長。

type Context interface {
  Deadline() (deadline time.Time, ok bool)
  Done() <-chan struct{}
  Err() error
  Value(key any) any
}

• Deadline方法，返回context.Context被取消的時間點，也就是需要完成任務(wù)的截止時間，連續(xù)調(diào)用返回相同的結(jié)果。
• Done方法， 當(dāng)前context被取消后，返回的channel就會被close。如果當(dāng)前context不會被取消則返回nil，連續(xù)調(diào)用返回相同的結(jié)果。
• Err方法，返回context.Context結(jié)束的錯誤

• 如果Done方法返回的channel沒有關(guān)閉，返回nil
• 如果Done方法返回的channel被關(guān)閉了，返回一個非nil的值，連續(xù)調(diào)用返回相同的結(jié)果

• context如果被取消了，返回 “context canceled”錯誤
• 如果執(zhí)行時間超過了Deadline，返回 “context deadline exceeded”錯誤

• Value方法，返回Context中key對應(yīng)的value值，對于同一個context，多次調(diào)用獲取同一個key的值會返回相同的結(jié)果。

如何構(gòu)造context.Context對象？

context包提供了兩個方法：

func Background() Context{}
func TODO() Context {}

• Background方法，返回一個空Context對象，所有Context對象的的源頭都應(yīng)該是這個空Context對象。
• TODO方法，也是返回一個空Context對象，如果還不確定使用何種Context時，可以使用此方法創(chuàng)建的Context對象。

目前context.Background和context.TODO方法沒有太大差別，返回的都是空Context，只是在使用場景和語義上稍有不同。其他的Context都需要基于構(gòu)造好的Context衍生出來，一個Context可以衍生多個子Context。

衍生Context方法

context包提供如下四個以With開頭的衍生Context的方法：

func WithCancel(parent Context) (ctx Context, cancel CancelFunc)
func WithDeadline(parent Context, d time.Time) (Context, CancelFunc)
func WithTimeout(parent Context, timeout time.Duration) (Context, CancelFunc)
func WithValue(parent Context, key, val any) Context

前三種方法的相同點都是基于parent Context生成一個新的Context并返回一個CancelFunc方法，CancelFunc調(diào)用后，當(dāng)前Context和基于新Context的子Context都會被取消。不同點在于WithCancel方法返回的CancelFunc需要手動調(diào)用；WithDeadline方法可以設(shè)置一個時間點，到這個時間點后會自動調(diào)用CancelFunc，當(dāng)然也可以手動調(diào)用；WithTimeout方法可以設(shè)置時長，超過指定時長后會自動調(diào)用CancelFunc，當(dāng)然也可以手動調(diào)用。

WithValue方法可以生成一個綁定指定的鍵值對數(shù)據(jù)的Context，可以通過context.Value(Key) 獲取指定key的值。

使用context包需要注意的點

• 需要Context參數(shù)的方法，把Context作為第一個參數(shù)（千萬不要把Context放在結(jié)構(gòu)體中，然后將結(jié)構(gòu)體作為參數(shù)傳遞）。
• 使用context.Background方法構(gòu)造的Context對象應(yīng)該作為根Context， 用于衍生其他Context。
• 方法需要傳入的Context類型不確定的時候，傳入使用context.TODO構(gòu)造的Context （千萬不要傳入nil）。
• 不要濫用context.WithValue傳遞數(shù)據(jù)，只用來傳遞必須的數(shù)據(jù)。
• Context是并發(fā)安全的，同一個Context可以傳遞給多個goroutine，可被多個goroutine同時訪問。

網(wǎng)站欄目：Golang中Context包基礎(chǔ)知識詳解
文章鏈接：http://uogjgqi.cn/article/dpchpod.html