博主在編寫Go代碼時，遇到了這樣一個問題：想要修改某個外部包，添加幾個函數，而其余功能繼續使用，經過調研，發現可以將Go的外部包源碼復制到項目本地，對包的代碼進行修改，從而達到目的。以下是對Go vendor的介紹。

功能

1. 復制依賴到本地go mod vendor 會根據項目的 go.mod 文件，將所有依賴模塊的源代碼復制到項目的 vendor 目錄中。這包括直接依賴和間接依賴，但不包括測試文件（如 *_test.go）以及依賴模塊中的 vendor 文件夾。
2. 離線構建支持通過將依賴項本地化，go mod vendor 允許項目在沒有網絡連接的情況下進行構建和測試，避免因依賴源不可用或網絡問題導致的構建失敗。
3. **構建時優先使用 vendor**在 Go 1.14 及更高版本中，如果項目目錄下存在 vendor 文件夾，Go 工具鏈會默認使用 vendor 中的依賴，而不是從遠程倉庫下載。

使用場景

1. 網絡不穩定或依賴源不可用在某些情況下，遠程依賴可能會因為網絡問題或模塊被刪除而無法訪問。使用 go mod vendor 可以確保項目的依賴完整性。
2. 構建環境隔離在構建 Docker 鏡像或部署到生產環境時，使用 vendor 目錄可以避免在構建過程中訪問外部網絡，從而提高安全性和效率。
3. 版本控制和依賴審查將 vendor 目錄提交到版本控制系統（如 Git）中，可以確保團隊成員或 CI/CD 環境使用完全一致的依賴版本，同時便于對依賴代碼進行審查。

使用方法

1. 初始化模塊：

   go mod init [module-name]
   

   生成 go.mod 文件。

2. 整理依賴：

   go mod tidy
   

   添加缺失的依賴或移除未使用的依賴。

3. 下載依賴：

   go mod download
   

   將依賴下載到本地緩存。

4. 生成 vendor 目錄：

   go mod vendor
   

   將依賴復制到項目的 vendor 目錄中。

5. 構建時使用 vendor 目錄：
   如果需要顯式指定使用 vendor，可以使用以下命令：

   go build -mod=vendor
   

優點

• 離線構建：確保項目在沒有網絡的情況下也能正常構建。
• 依賴穩定性：避免遠程依賴被刪除或版本變更導致的構建失敗。
• 安全性：減少對外部網絡的依賴，降低安全風險。

缺點

• 增加項目體積：vendor 目錄會顯著增加項目的存儲空間，尤其是依賴較多時。
• 版本管理復雜性：需要手動更新 vendor 目錄，可能導致版本管理不夠靈活。
• 社區趨勢：隨著 Go Modules 的普及，vendor 的使用逐漸減少，更多項目傾向于直接使用模塊緩存和 Go Proxy。

總結

go mod vendor 是 Go Modules 提供的一種依賴管理方式，適用于需要離線構建或對依賴有嚴格控制的場景。然而，隨著 Go Proxy 和模塊緩存的完善，其使用頻率逐漸降低。在選擇是否使用 vendor 時，應根據項目需求權衡其優缺點。