Go語言代碼覆蓋率實現

一、什麼是代碼覆蓋率

　　代碼覆蓋率是軟件測試中的一種白盒測試度量指標，表示程序源代碼中被執行的比例。簡單來説，就是“我的測試到底跑過多少代碼”。

覆蓋率常見的幾種標準：

語句覆蓋（段覆蓋、基本塊覆蓋）：每一行代碼是否至少執行過一次
分支覆蓋：程序中的每個判斷(if/else)是否都執行過true和false兩種結果
條件覆蓋：判斷語句中的每個子條件是否都覆蓋到true/false
路徑覆蓋：是否走過程序的所有可能路徑，路徑覆蓋通常最嚴格，但代價也最大。

　　覆蓋率並不是越高越好，但如果覆蓋率過低，就一定意味着測試不充分。

//1.語句覆蓋率
//只保證每條語句被執行，不保證邏輯分支是否被充分驗證
if x > 0 {
    fmt.Println("Positive")
} else {
    fmt.Println("Non-positive")
}

//2.分支覆蓋
//比語句覆蓋更強，能保證分支邏輯完整被測。但不能保證複合邏輯條件中的所有子條件都被覆蓋。
if x > 0 && y > 0 {
    fmt.Println("x>0 and y>0")
}
//分支覆蓋只要求覆蓋 if 為真和假各一次。
//可能測試了 (x=1,y=1) 和 (x=-1,y=-1)，就算達到了分支覆蓋，但沒保證 y>0 單獨為假時的情況。

//3.條件覆蓋
//保證每個布爾子條件（子表達式）至少取過一次 true 和 false。
if (x > 0 || y > 0) {
    fmt.Println("Condition True")
}
//(x=1, y=1) → 兩個條件都 true
//(x=1, y=-1) → x true，y false
//(x=-1, y=1) → x false，y true
//👉 但是注意：並沒有測試到 (x=-1, y=-1) 的情況。

//4.路徑覆蓋
//if (x > 0 && y > 0) 實際上有 4 種組合：
//(true, true) → if 條件成立 → 進入 println
//(true, false) → if 條件不成立 → 不打印
//(false, true) → if 條件不成立 → 不打印
//(false, false) → if 條件不成立 → 不打印

條件覆蓋： 關注的是子條件本身取沒取過 true/false。

路徑覆蓋： 關注的是整個條件組合下程序的執行路徑有沒有覆蓋全。

二、代碼覆蓋率的意義

　　為什麼要關心覆蓋率?

發現測試盲區：通過未覆蓋代碼，可以反推測試設計是否有遺漏
發現廢代碼：有些邏輯永遠跑不到，可能是無效代碼
質量評估工具：覆蓋率高不等於測試質量高，但覆蓋率低往往意味着測試存在缺陷。

三、Go語言的覆蓋率工具

　　Go 語言自帶了覆蓋率工具，無需額外安裝包。核心思想是：
👉 編譯前自動在源碼中“埋點”，運行時收集統計信息，最後輸出覆蓋率數據。

//score.go
package main

func GetGrade(score int) string {
    if score >= 60 {
        return "pass"
    }
    return "fail"
}

//score_test.go
package main

import "testing"

func TestGetGrade(t *testing.T) {
    tests := []struct {
        score int
        want  string
    }{
        {50, "fail"},
        {80, "pass"},
    }

    for _, tt := range tests {
        got := GetGrade(tt.score)
        if got != tt.want {
            t.Errorf("GetGrade(%d) = %s; want %s", tt.score, got, tt.want)
        }
    }
}

注意：

測試文件必須以 _test.go 結尾。
測試函數必須以 Test 開頭，參數為 t *testing.T。

四、運行覆蓋率分析

1、查看覆蓋率百分比

go test -cover

//輸出結果類似
PASS
coverage: 66.7% of statements

2、生成覆蓋率數據文件

go test -coverprofile=coverage.out

//執行後，會在當前目錄生成 coverage.out 文件，裏面記錄了每行代碼是否被執行。

3、查看詳細函數覆蓋率

go tool cover -func=coverage.out

//輸出示例
score.go:3:   GetGrade  100.0%
total:        (statements) 100.0%

4、用HTML可視化展示

go tool cover -html=coverage.out

瀏覽器會打開一份高亮源碼報告：

綠色 = 覆蓋到
紅色 = 未覆蓋

五、項目實戰：收集服務端覆蓋率

　　在實際項目中，我們可能需要收集 整個服務在運行過程中的覆蓋率，而不僅僅是單元測試。比如執行完所有自動化用例後，再統計覆蓋率。

//1.創建maint_test.go
//為main()函數增加測試入口

package main

import "testing"

func TestMainFunc(t *testing.T) {
    main()
}
//如果 main() 裏有 os.Exit()，需要改成 return，避免提前退出。

//2.編譯測試二進制文件
go test -covermode=count -coverpkg=./... -c -o app.test

-covermode=count：統計覆蓋次數。

-coverpkg=./...：指定需要統計覆蓋率的所有源碼。

-o app.test：生成帶覆蓋率信息的可執行文件。

//3.運行並收集覆蓋率
//啓動服務時加上：./app.test -test.coverprofile=coverage.cov

//4.生成最終報告
go tool cover -html=coverage.cov -o coverage.html
//打開 coverage.html，就能看到完整的覆蓋率分析。