本教程介紹了 Go 中模糊測(cè)試的基礎(chǔ)知識(shí)。通過(guò)模糊測(cè)試，隨機(jī)數(shù)據(jù)會(huì)針對(duì)您的測(cè)試運(yùn)行，以嘗試找出漏洞或?qū)е卤罎⒌妮斎??？梢酝ㄟ^(guò)模糊測(cè)試發(fā)現(xiàn)的一些漏洞示例包括 SQL 注入、緩沖區(qū)溢出、拒絕服務(wù)和跨站點(diǎn)腳本攻擊。
為神池等地區(qū)用戶(hù)提供了全套網(wǎng)頁(yè)設(shè)計(jì)制作服務(wù)，及神池網(wǎng)站建設(shè)行業(yè)解決方案。主營(yíng)業(yè)務(wù)為做網(wǎng)站、成都網(wǎng)站制作、神池網(wǎng)站設(shè)計(jì)，以傳統(tǒng)方式定制建設(shè)網(wǎng)站，并提供域名空間備案等一條龍服務(wù)，秉承以專(zhuān)業(yè)、用心的態(tài)度為用戶(hù)提供真誠(chéng)的服務(wù)。我們深信只要達(dá)到每一位用戶(hù)的要求，就會(huì)得到認(rèn)可，從而選擇與我們長(zhǎng)期合作。這樣，我們也可以走得更遠(yuǎn)！
在本教程中，您將為一個(gè)簡(jiǎn)單的函數(shù)編寫(xiě)一個(gè)模糊測(cè)試，運(yùn)行 go 命令，并調(diào)試和修復(fù)代碼中的問(wèn)題。
首先，為您要編寫(xiě)的代碼創(chuàng)建一個(gè)文件夾。
1、打開(kāi)命令提示符并切換到您的主目錄。
在 Linux 或 Mac 上：
在 Windows 上：
2、在命令提示符下，為您的代碼創(chuàng)建一個(gè)名為 fuzz 的目錄。
3、創(chuàng)建一個(gè)模塊來(lái)保存您的代碼。
運(yùn)行g(shù)o mod init命令，為其提供新代碼的模塊路徑。
接下來(lái)，您將添加一些簡(jiǎn)單的代碼來(lái)反轉(zhuǎn)字符串，稍后我們將對(duì)其進(jìn)行模糊測(cè)試。
在此步驟中，您將添加一個(gè)函數(shù)來(lái)反轉(zhuǎn)字符串。
a.使用您的文本編輯器，在 fuzz 目錄中創(chuàng)建一個(gè)名為 main.go 的文件。
獨(dú)立程序（與庫(kù)相反）始終位于 package 中main。
此函數(shù)將接受string，使用byte進(jìn)行循環(huán) ，并在最后返回反轉(zhuǎn)的字符串。
此函數(shù)將運(yùn)行一些Reverse操作，然后將輸出打印到命令行。這有助于查看運(yùn)行中的代碼，并可能有助于調(diào)試。
e.該main函數(shù)使用 fmt 包，因此您需要導(dǎo)入它。
第一行代碼應(yīng)如下所示：
從包含 main.go 的目錄中的命令行，運(yùn)行代碼。
可以看到原來(lái)的字符串，反轉(zhuǎn)它的結(jié)果，然后再反轉(zhuǎn)它的結(jié)果，就相當(dāng)于原來(lái)的了。
現(xiàn)在代碼正在運(yùn)行，是時(shí)候測(cè)試它了。
在這一步中，您將為Reverse函數(shù)編寫(xiě)一個(gè)基本的單元測(cè)試。
a.使用您的文本編輯器，在 fuzz 目錄中創(chuàng)建一個(gè)名為 reverse_test.go 的文件。
b.將以下代碼粘貼到 reverse_test.go 中。
這個(gè)簡(jiǎn)單的測(cè)試將斷言列出的輸入字符串將被正確反轉(zhuǎn)。
使用運(yùn)行單元測(cè)試go test
接下來(lái)，您將單元測(cè)試更改為模糊測(cè)試。
單元測(cè)試有局限性，即每個(gè)輸入都必須由開(kāi)發(fā)人員添加到測(cè)試中。模糊測(cè)試的一個(gè)好處是它可以為您的代碼提供輸入，并且可以識(shí)別您提出的測(cè)試用例沒(méi)有達(dá)到的邊緣用例。
在本節(jié)中，您將單元測(cè)試轉(zhuǎn)換為模糊測(cè)試，這樣您就可以用更少的工作生成更多的輸入！
請(qǐng)注意，您可以將單元測(cè)試、基準(zhǔn)測(cè)試和模糊測(cè)試保存在同一個(gè) *_test.go 文件中，但對(duì)于本示例，您將單元測(cè)試轉(zhuǎn)換為模糊測(cè)試。
在您的文本編輯器中，將 reverse_test.go 中的單元測(cè)試替換為以下模糊測(cè)試。
Fuzzing 也有一些限制。在您的單元測(cè)試中，您可以預(yù)測(cè)Reverse函數(shù)的預(yù)期輸出，并驗(yàn)證實(shí)際輸出是否滿(mǎn)足這些預(yù)期。
例如，在測(cè)試用例Reverse("Hello, world")中，單元測(cè)試將返回指定為"dlrow ,olleH".
模糊測(cè)試時(shí)，您無(wú)法預(yù)測(cè)預(yù)期輸出，因?yàn)槟鸁o(wú)法控制輸入。
但是，Reverse您可以在模糊測(cè)試中驗(yàn)證函數(shù)的一些屬性。在這個(gè)模糊測(cè)試中檢查的兩個(gè)屬性是：
（1）將字符串反轉(zhuǎn)兩次保留原始值
（2）反轉(zhuǎn)的字符串將其狀態(tài)保留為有效的 UTF-8。
注意單元測(cè)試和模糊測(cè)試之間的語(yǔ)法差異：
（3）確保新包unicode/utf8已導(dǎo)入。
隨著單元測(cè)試轉(zhuǎn)換為模糊測(cè)試，是時(shí)候再次運(yùn)行測(cè)試了。
a.在不進(jìn)行模糊測(cè)試的情況下運(yùn)行模糊測(cè)試，以確保種子輸入通過(guò)。
如果您在該文件中有其他測(cè)試，您也可以運(yùn)行g(shù)o test -run=FuzzReverse，并且您只想運(yùn)行模糊測(cè)試。
b.運(yùn)行FuzzReverse模糊測(cè)試，查看是否有任何隨機(jī)生成的字符串輸入會(huì)導(dǎo)致失敗。這是使用go test新標(biāo)志-fuzz執(zhí)行的。
模糊測(cè)試時(shí)發(fā)生故障，導(dǎo)致問(wèn)題的輸入被寫(xiě)入將在下次運(yùn)行的種子語(yǔ)料庫(kù)文件中g(shù)o test，即使沒(méi)有-fuzz標(biāo)志也是如此。要查看導(dǎo)致失敗的輸入，請(qǐng)?jiān)谖谋揪庉嬈髦写蜷_(kāi)寫(xiě)入 testdata/fuzz/FuzzReverse 目錄的語(yǔ)料庫(kù)文件。您的種子語(yǔ)料庫(kù)文件可能包含不同的字符串，但格式相同。
語(yǔ)料庫(kù)文件的第一行表示編碼版本。以下每一行代表構(gòu)成語(yǔ)料庫(kù)條目的每種類(lèi)型的值。由于 fuzz target 只需要 1 個(gè)輸入，因此版本之后只有 1 個(gè)值。
c.運(yùn)行沒(méi)有-fuzz標(biāo)志的go test； 新的失敗種子語(yǔ)料庫(kù)條目將被使用：
由于我們的測(cè)試失敗，是時(shí)候調(diào)試了。
當(dāng)您對(duì)外部模塊的存儲(chǔ)庫(kù)進(jìn)行了 fork （例如修復(fù)模塊代碼中的問(wèn)題或添加功能）時(shí)，您可以讓 Go 工具將您的 fork 用于模塊的源代碼。這對(duì)于測(cè)試您自己的代碼的更改很有用。
為此，您可以使用go.mod 文件中的replace指令將外部模塊的原始模塊路徑替換為存儲(chǔ)庫(kù)中 fork 的路徑。這指示 Go 工具在編譯時(shí)使用替換路徑（fork 的位置），例如，同時(shí)允許您保留import 原始模塊路徑中的語(yǔ)句不變。
在以下 go.mod 文件示例中，當(dāng)前模塊需要外部模塊example.com/theirmodule。然后該replace指令將原始模塊路徑替換為example.com/myfork/theirmodule模塊自己的存儲(chǔ)庫(kù)的分支。
設(shè)置require/replace對(duì)時(shí)，使用 Go 工具命令確保文件描述的需求保持一致。使用go list命令獲取當(dāng)前模塊正在使用的版本。然后使用go mod edit命令將需要的模塊替換為fork：
注意： 當(dāng)您使用該replace指令時(shí)，Go 工具不會(huì)像添加依賴(lài)項(xiàng)中所述對(duì)外部模塊進(jìn)行身份驗(yàn)證。
您可以使用go get命令從其存儲(chǔ)庫(kù)中的特定提交為模塊添加未發(fā)布的代碼。
為此，您使用go get命令，用符號(hào)@指定您想要的代碼 。當(dāng)您使用go get時(shí)，該命令將向您的 go.mod 文件添加一個(gè) 需要外部模塊的require指令，使用基于有關(guān)提交的詳細(xì)信息的偽版本號(hào)。
以下示例提供了一些說(shuō)明。這些基于源位于 git 存儲(chǔ)庫(kù)中的模塊。
當(dāng)您的代碼不再使用模塊中的任何包時(shí)，您可以停止將該模塊作為依賴(lài)項(xiàng)進(jìn)行跟蹤。
要停止跟蹤所有未使用的模塊，請(qǐng)運(yùn)行g(shù)o mod tidy 命令。此命令還可能添加在模塊中構(gòu)建包所需的缺失依賴(lài)項(xiàng)。
要?jiǎng)h除特定依賴(lài)項(xiàng)，請(qǐng)使用go get，指定模塊的模塊路徑并附加 @none，如下例所示：
go get命令還將降級(jí)或刪除依賴(lài)于已刪除模塊的其他依賴(lài)項(xiàng)。
當(dāng)您使用 Go 工具處理模塊時(shí)，這些工具默認(rèn)從 proxy.golang.org（一個(gè)公共的 Google 運(yùn)行的模塊鏡像）或直接從模塊的存儲(chǔ)庫(kù)下載模塊。您可以指定 Go 工具應(yīng)該使用另一個(gè)代理服務(wù)器來(lái)下載和驗(yàn)證模塊。
如果您（或您的團(tuán)隊(duì)）已經(jīng)設(shè)置或選擇了您想要使用的不同模塊代理服務(wù)器，您可能想要這樣做。例如，有些人設(shè)置了模塊代理服務(wù)器，以便更好地控制依賴(lài)項(xiàng)的使用方式。
要為 Go 工具指定另一個(gè)模塊代理服務(wù)器，請(qǐng)將GOPROXY 環(huán)境變量設(shè)置為一個(gè)或多個(gè)服務(wù)器的 URL。Go 工具將按照您指定的順序嘗試每個(gè) URL。默認(rèn)情況下，GOPROXY首先指定一個(gè)公共的 Google 運(yùn)行模塊代理，然后從模塊的存儲(chǔ)庫(kù)直接下載（在其模塊路徑中指定）：
您可以將變量設(shè)置為其他模塊代理服務(wù)器的 URL，用逗號(hào)或管道分隔 URL。
Go 模塊經(jīng)常在公共互聯(lián)網(wǎng)上不可用的版本控制服務(wù)器和模塊代理上開(kāi)發(fā)和分發(fā)。您可以設(shè)置 GOPRIVATE環(huán)境變量。您可以設(shè)置GOPRIVATE環(huán)境變量來(lái)配置go命令以從私有源下載和構(gòu)建模塊。然后 go 命令可以從私有源下載和構(gòu)建模塊。
GOPRIVATE或環(huán)境變量可以設(shè)置為匹配模塊前綴的全局模式列表，這些GONOPROXY前綴是私有的，不應(yīng)從任何代理請(qǐng)求。例如：
本教程介紹了使用 Godatabase/sql及其標(biāo)準(zhǔn)庫(kù)中的包訪(fǎng)問(wèn)關(guān)系數(shù)據(jù)庫(kù)的基礎(chǔ)知識(shí)。
您將使用的database/sql包包括用于連接數(shù)據(jù)庫(kù)、執(zhí)行事務(wù)、取消正在進(jìn)行的操作等的類(lèi)型和函數(shù)。
在本教程中，您將創(chuàng)建一個(gè)數(shù)據(jù)庫(kù)，然后編寫(xiě)代碼來(lái)訪(fǎng)問(wèn)該數(shù)據(jù)庫(kù)。您的示例項(xiàng)目將是有關(guān)老式爵士樂(lè)唱片的數(shù)據(jù)存儲(chǔ)庫(kù)。
首先，為您要編寫(xiě)的代碼創(chuàng)建一個(gè)文件夾。
1、打開(kāi)命令提示符并切換到您的主目錄。
在 Linux 或 Mac 上：
在 Windows 上：
2、在命令提示符下，為您的代碼創(chuàng)建一個(gè)名為 data-access 的目錄。
3、創(chuàng)建一個(gè)模塊，您可以在其中管理將在本教程中添加的依賴(lài)項(xiàng)。
運(yùn)行g(shù)o mod init命令，為其提供新代碼的模塊路徑。
此命令創(chuàng)建一個(gè) go.mod 文件，您添加的依賴(lài)項(xiàng)將在其中列出以供跟蹤。
注意： 在實(shí)際開(kāi)發(fā)中，您會(huì)指定一個(gè)更符合您自己需求的模塊路徑。有關(guān)更多信息，請(qǐng)參閱一下文章。
GO語(yǔ)言（二十五）：管理依賴(lài)項(xiàng)（上）
GO語(yǔ)言（二十六）：管理依賴(lài)項(xiàng)（中）
GO語(yǔ)言（二十七）：管理依賴(lài)項(xiàng)（下）
接下來(lái)，您將創(chuàng)建一個(gè)數(shù)據(jù)庫(kù)。
在此步驟中，您將創(chuàng)建要使用的數(shù)據(jù)庫(kù)。您將使用 DBMS 本身的 CLI 創(chuàng)建數(shù)據(jù)庫(kù)和表，以及添加數(shù)據(jù)。
您將創(chuàng)建一個(gè)數(shù)據(jù)庫(kù)，其中包含有關(guān)黑膠唱片上的老式爵士樂(lè)錄音的數(shù)據(jù)。
這里的代碼使用MySQL CLI，但大多數(shù) DBMS 都有自己的 CLI，具有類(lèi)似的功能。
1、打開(kāi)一個(gè)新的命令提示符。
在命令行，登錄到您的 DBMS，如下面的 MySQL 示例所示。
2、在mysql命令提示符下，創(chuàng)建一個(gè)數(shù)據(jù)庫(kù)。
3、切到您剛剛創(chuàng)建的數(shù)據(jù)庫(kù)，以便您可以添加表。
4、在文本編輯器的 data-access 文件夾中，創(chuàng)建一個(gè)名為 create-tables.sql 的文件來(lái)保存用于添加表的 SQL 腳本。
將以下 SQL 代碼粘貼到文件中，然后保存文件。
在此 SQL 代碼中：
（1）刪除名為album表。 首先執(zhí)行此命令可以讓您更輕松地稍后重新運(yùn)行腳本。
（2）創(chuàng)建一個(gè)album包含四列的表：title、artist和price。每行的id值由 DBMS 自動(dòng)創(chuàng)建。
（3）添加帶有值的四行。
5、在mysql命令提示符下，運(yùn)行您剛剛創(chuàng)建的腳本。
您將使用以下形式的source命令：
6、在 DBMS 命令提示符處，使用SELECT語(yǔ)句來(lái)驗(yàn)證您是否已成功創(chuàng)建包含數(shù)據(jù)的表。
接下來(lái)，您將編寫(xiě)一些 Go 代碼進(jìn)行連接，以便進(jìn)行查詢(xún)。
現(xiàn)在你已經(jīng)有了一個(gè)包含一些數(shù)據(jù)的數(shù)據(jù)庫(kù)，開(kāi)始你的 Go 代碼。
找到并導(dǎo)入一個(gè)數(shù)據(jù)庫(kù)驅(qū)動(dòng)程序，該驅(qū)動(dòng)程序會(huì)將您通過(guò)database/sql包中的函數(shù)發(fā)出的請(qǐng)求轉(zhuǎn)換為數(shù)據(jù)庫(kù)可以理解的請(qǐng)求。
1、在您的瀏覽器中，訪(fǎng)問(wèn)SQLDrivers wiki 頁(yè)面以識(shí)別您可以使用的驅(qū)動(dòng)程序。
2、使用頁(yè)面上的列表來(lái)識(shí)別您將使用的驅(qū)動(dòng)程序。為了在本教程中訪(fǎng)問(wèn) MySQL，您將使用 Go-MySQL-Driver。
3、請(qǐng)注意驅(qū)動(dòng)程序的包名稱(chēng) - 此處為github.com/go-sql-driver/mysql.
4、使用您的文本編輯器，創(chuàng)建一個(gè)用于編寫(xiě) Go 代碼的文件，并將該文件作為 main.go 保存在您之前創(chuàng)建的數(shù)據(jù)訪(fǎng)問(wèn)目錄中。
5、進(jìn)入main.go，粘貼以下代碼導(dǎo)入驅(qū)動(dòng)包。
在此代碼中：
（1）將您的代碼添加到main包中，以便您可以獨(dú)立執(zhí)行它。
（2）導(dǎo)入 MySQL 驅(qū)動(dòng)程序github.com/go-sql-driver/mysql。
導(dǎo)入驅(qū)動(dòng)程序后，您將開(kāi)始編寫(xiě)代碼以訪(fǎng)問(wèn)數(shù)據(jù)庫(kù)。
現(xiàn)在編寫(xiě)一些 Go 代碼，讓您使用數(shù)據(jù)庫(kù)句柄訪(fǎng)問(wèn)數(shù)據(jù)庫(kù)。
您將使用指向結(jié)構(gòu)的指針sql.DB，它表示對(duì)特定數(shù)據(jù)庫(kù)的訪(fǎng)問(wèn)。
編寫(xiě)代碼
1、進(jìn)入 main.go，在import您剛剛添加的代碼下方，粘貼以下 Go 代碼以創(chuàng)建數(shù)據(jù)庫(kù)句柄。
在此代碼中：
（3）使用 MySQL 驅(qū)動(dòng)程序Config和FormatDSN類(lèi)型以收集連接屬性并將它們格式化為連接字符串的 DSN。
該Config結(jié)構(gòu)使代碼比連接字符串更容易閱讀。
（4）調(diào)用sql.Open 初始化db變量，傳遞 FormatDSN。
（5）檢查來(lái)自 的錯(cuò)誤sql.Open。例如，如果您的數(shù)據(jù)庫(kù)連接細(xì)節(jié)格式不正確，它可能會(huì)失敗。
為了簡(jiǎn)化代碼，您調(diào)用log.Fatal結(jié)束執(zhí)行并將錯(cuò)誤打印到控制臺(tái)。在生產(chǎn)代碼中，您會(huì)希望以更優(yōu)雅的方式處理錯(cuò)誤。
（6）調(diào)用DB.Ping以確認(rèn)連接到數(shù)據(jù)庫(kù)有效。在運(yùn)行時(shí)， sql.Open可能不會(huì)立即連接，具體取決于驅(qū)動(dòng)程序。您在Ping此處使用以確認(rèn) database/sql包可以在需要時(shí)連接。
（7）檢查來(lái)自Ping的錯(cuò)誤，以防連接失敗。
（8）Ping如果連接成功，則打印一條消息。
文件的頂部現(xiàn)在應(yīng)該如下所示：
3、保存 main.go。
1、開(kāi)始跟蹤 MySQL 驅(qū)動(dòng)程序模塊作為依賴(lài)項(xiàng)。
使用go get 添加 github.com/go-sql-driver/mysql 模塊作為您自己模塊的依賴(lài)項(xiàng)。使用點(diǎn)參數(shù)表示“獲取當(dāng)前目錄中代碼的依賴(lài)項(xiàng)”。
2、在命令提示符下，設(shè)置Go 程序使用的DBUSER和DBPASS環(huán)境變量。
在 Linux 或 Mac 上：
在 Windows 上：
3、在包含 main.go 的目錄中的命令行中，通過(guò)鍵入go run來(lái)運(yùn)行代碼。
連接成功了！
接下來(lái)，您將查詢(xún)一些數(shù)據(jù)。
cobra是一個(gè)提供簡(jiǎn)單接口來(lái)創(chuàng)建強(qiáng)大的現(xiàn)代CLI界面的庫(kù)類(lèi)似git git tools，cobra也是一個(gè)應(yīng)用程序，它會(huì)生成你的應(yīng)用程序的腳手架來(lái)快速開(kāi)發(fā)基于cobra的應(yīng)用程序
cobra提供：
cobra建立在命令、參數(shù)、標(biāo)志的結(jié)構(gòu)之上
commands代表動(dòng)作，args是事物，flags是動(dòng)作的修飾符
最好的應(yīng)用程序在使用時(shí)讀起來(lái)就像句子，因此，用戶(hù)直觀地知道如何與它們交互
模式如下：APPNAME VERB NOUN --ADJECTIVE. or APPNAME COMMAND ARG --FLAG（APPNAME 動(dòng)詞 名詞 形容詞 或者 APPNAME 命令 參數(shù) 標(biāo)志）
一些真實(shí)世界的好例子可以更好地說(shuō)明這一點(diǎn)
kubectl 命令更能體現(xiàn)APPNAME 動(dòng)詞 名詞 形容詞
如下的例子，server 是command，port是flag
這個(gè)命令中，我們告訴git 克隆url
命令是應(yīng)用程序的中心點(diǎn)，應(yīng)用程序支持的每一個(gè)交互都包含在一個(gè)命令中，命令可以有子命令，也可以運(yùn)行操作
在上面的例子中，server是命令
更多關(guān)于cobra.Command
flag是一種修改命令行為的方式，cobra支持完全兼容POSIX標(biāo)志，也支持go flag package，cobra可以定義到子命令上的標(biāo)志，也可以?xún)H對(duì)該命令可用的標(biāo)志
在上面的命令中，port是標(biāo)志
標(biāo)志的功能由 pflag library 提供，pflag library是flag標(biāo)準(zhǔn)庫(kù)的一個(gè)分支，在添加POSIX兼容性的同時(shí)維護(hù)相同的接口。
使用cobra很簡(jiǎn)單，首先，使用go get按照最新版本的庫(kù)，這個(gè)命令會(huì)安裝cobra可執(zhí)行程序以及庫(kù)和依賴(lài)項(xiàng)
下一步，引入cobra到應(yīng)用程序中
雖然歡迎您提供自己的組織，但通?；贑obra的應(yīng)用程序?qū)⒆裱韵陆M織結(jié)構(gòu)：
在Cobra應(yīng)用程序中，main.go文件通常非常簡(jiǎn)單。它有一個(gè)目的：初始化Cobra。
使用cobra生成器
cobra提供了程序用來(lái)創(chuàng)建你的應(yīng)用程序然后添加你想添加的命令，這是將cobra引入應(yīng)用程序最簡(jiǎn)單的方式
這兒 你可以發(fā)現(xiàn)關(guān)于cobra的更多信息
要手動(dòng)實(shí)現(xiàn)cobra，需要?jiǎng)?chuàng)建一個(gè)main.go 和rootCmd文件，可以根據(jù)需要提供其他命令
Cobra不需要任何特殊的構(gòu)造器。只需創(chuàng)建命令。
理想情況下，您可以將其放在app/cmd/root.go中：
在init（）函數(shù)中定義標(biāo)志和處理配置
例子如下，cmd/root.go:
創(chuàng)建main.go
使用root命令，您需要讓主函數(shù)執(zhí)行它。為清楚起見(jiàn)，Execute應(yīng)該在根目錄下運(yùn)行，盡管它可以在任何命令上調(diào)用。
在Cobra應(yīng)用程序中，main.go文件通常非常簡(jiǎn)單。它有一個(gè)目的：初始化Cobra。
可以定義其他命令，通常每個(gè)命令在cmd/目錄中都有自己的文件。
如果要?jiǎng)?chuàng)建版本命令，可以創(chuàng)建cmd/version.go并用以下內(nèi)容填充它：
如果希望將錯(cuò)誤返回給命令的調(diào)用者，可以使用RunE。
然后可以在execute函數(shù)調(diào)用中捕獲錯(cuò)誤。
標(biāo)志提供修飾符來(lái)控制操作命令的操作方式。
由于標(biāo)志是在不同的位置定義和使用的，因此我們需要在外部定義一個(gè)具有正確作用域的變量來(lái)分配要使用的標(biāo)志。
有兩種不同的方法來(lái)分配標(biāo)志。
標(biāo)志可以是“持久”的，這意味著該標(biāo)志將可用于分配給它的命令以及該命令下的每個(gè)命令。對(duì)于全局標(biāo)志，在根上指定一個(gè)標(biāo)志作為持久標(biāo)志。
也可以在本地分配一個(gè)標(biāo)志，該標(biāo)志只應(yīng)用于該特定命令。
默認(rèn)情況下，Cobra只解析目標(biāo)命令上的本地標(biāo)志，而忽略父命令上的任何本地標(biāo)志。通過(guò)啟用Command.TraverseChildren，Cobra將在執(zhí)行目標(biāo)命令之前解析每個(gè)命令上的本地標(biāo)志。
使用viper綁定標(biāo)志
在本例中，持久標(biāo)志author與viper綁定。注意：當(dāng)用戶(hù)未提供--author標(biāo)志時(shí)，變量author將不會(huì)設(shè)置為config中的值。
更多關(guān)于 viper的文檔
Flags默認(rèn)是可選的，如果希望命令在未設(shè)置標(biāo)志時(shí)報(bào)告錯(cuò)誤，請(qǐng)根據(jù)需要進(jìn)行標(biāo)記：
持久性Flags
可以使用命令的Args字段指定位置參數(shù)的驗(yàn)證。
內(nèi)置了以下驗(yàn)證器：
在下面的示例中，我們定義了三個(gè)命令。兩個(gè)是頂級(jí)命令，一個(gè)（cmdTimes）是頂級(jí)命令之一的子命令。在這種情況下，根是不可執(zhí)行的，這意味著需要一個(gè)子命令。這是通過(guò)不為“rootCmd”提供“Run”來(lái)實(shí)現(xiàn)的。
我們只為一個(gè)命令定義了一個(gè)標(biāo)志。
有關(guān)標(biāo)志的更多文檔，請(qǐng)?jiān)L問(wèn)
對(duì)于一個(gè)更完整的例子更大的應(yīng)用程序，請(qǐng)檢查 Hugo 。
當(dāng)您有子命令時(shí)，Cobra會(huì)自動(dòng)將help命令添加到應(yīng)用程序中。當(dāng)用戶(hù)運(yùn)行“應(yīng)用程序幫助”時(shí)，將調(diào)用此函數(shù)。此外，help還支持所有其他命令作為輸入。例如，您有一個(gè)名為“create”的命令，沒(méi)有任何附加配置；調(diào)用“app help create”時(shí)，Cobra將起作用。每個(gè)命令都會(huì)自動(dòng)添加“-help”標(biāo)志。
以下輸出由Cobra自動(dòng)生成。除了命令和標(biāo)志定義之外，不需要任何東西。
幫助就像其他命令一樣。它周?chē)鷽](méi)有特殊的邏輯或行為。事實(shí)上，你可以提供你想提供的。
您可以為默認(rèn)命令提供自己的幫助命令或模板，以用于以下功能：
當(dāng)用戶(hù)提供無(wú)效的標(biāo)志或無(wú)效的命令時(shí)，Cobra通過(guò)向用戶(hù)顯示“用法”來(lái)響應(yīng)。
你可以從上面的幫助中認(rèn)識(shí)到這一點(diǎn)。這是因?yàn)槟J(rèn)幫助將用法作為其輸出的一部分嵌入。
您可以提供自己的使用函數(shù)或模板供Cobra使用。與幫助一樣，函數(shù)和模板也可以通過(guò)公共方法重寫(xiě)：
如果在root命令上設(shè)置了version字段，Cobra會(huì)添加一個(gè)頂級(jí)的'--version'標(biāo)志。運(yùn)行帶有“-version”標(biāo)志的應(yīng)用程序?qū)⑹褂冒姹灸０鍖姹敬蛴〉綐?biāo)準(zhǔn)輸出?？梢允褂胏md.SetVersionTemplate（s string）函數(shù)自定義模板。
可以在命令的主運(yùn)行函數(shù)之前或之后運(yùn)行函數(shù)。PersistentPreRun和PreRun函數(shù)將在運(yùn)行之前執(zhí)行。PersistentPostRun和PostRun將在運(yùn)行后執(zhí)行。如果子函數(shù)不聲明自己的函數(shù)，則它們將繼承Persistent*Run函數(shù)。這些函數(shù)按以下順序運(yùn)行：
輸出：
當(dāng)發(fā)生“未知命令”錯(cuò)誤時(shí)，Cobra將打印自動(dòng)建議。這使得Cobra在發(fā)生拼寫(xiě)錯(cuò)誤時(shí)的行為類(lèi)似于git命令。例如：
基于注冊(cè)的每個(gè)子命令和Levenshtein距離的實(shí)現(xiàn)，建議是自動(dòng)的。匹配最小距離2（忽略大小寫(xiě)）的每個(gè)已注冊(cè)命令都將顯示為建議。
如果需要在命令中禁用建議或調(diào)整字符串距離，請(qǐng)使用：
or
您還可以使用SuggestFor屬性顯式設(shè)置將為其建議給定命令的名稱(chēng)。這允許對(duì)在字符串距離方面不接近的字符串提供建議，但在您的一組命令中是有意義的，并且對(duì)于某些您不需要?jiǎng)e名的字符串。例子：
Cobra可以基于子命令、標(biāo)志等生成文檔。請(qǐng)?jiān)?docs generation文檔 中閱讀更多關(guān)于它的信息。
Cobra可以為以下shell生成shell完成文件：bash、zsh、fish、PowerShell。如果您在命令中添加更多信息，這些補(bǔ)全功能將非常強(qiáng)大和靈活。在 Shell Completions 中閱讀更多關(guān)于它的信息。
Cobra is released under the Apache 2.0 license. See LICENSE.txt
本教程介紹 Go 中多模塊工作區(qū)的基礎(chǔ)知識(shí)。使用多模塊工作區(qū)，您可以告訴 Go 命令您正在同時(shí)在多個(gè)模塊中編寫(xiě)代碼，并輕松地在這些模塊中構(gòu)建和運(yùn)行代碼。
在本教程中，您將在共享的多模塊工作區(qū)中創(chuàng)建兩個(gè)模塊，對(duì)這些模塊進(jìn)行更改，并在構(gòu)建中查看這些更改的結(jié)果。
本教程需要 go1.18 或更高版本。使用go.dev/dl中的鏈接確保您已在 Go 1.18 或更高版本中安裝了 Go 。
首先，為您要編寫(xiě)的代碼創(chuàng)建一個(gè)模塊。
1、打開(kāi)命令提示符并切換到您的主目錄。
在 Linux 或 Mac 上：
在 Windows 上：
2、在命令提示符下，為您的代碼創(chuàng)建一個(gè)名為工作區(qū)的目錄。
3、初始化模塊
我們的示例將創(chuàng)建一個(gè)hello依賴(lài)于 golang.org/x/example 模塊的新模塊。
創(chuàng)建你好模塊：
使用 . 添加對(duì) golang.org/x/example 模塊的依賴(lài)項(xiàng)go get。
在 hello 目錄下創(chuàng)建 hello.go，內(nèi)容如下：
現(xiàn)在，運(yùn)行 hello 程序：
在這一步中，我們將創(chuàng)建一個(gè)go.work文件來(lái)指定模塊的工作區(qū)。
在workspace目錄中，運(yùn)行：
該go work init命令告訴為包含目錄中模塊的工作空間go創(chuàng)建一個(gè)文件 。go.work./hello
該go命令生成一個(gè)go.work如下所示的文件：
該go.work文件的語(yǔ)法與go.mod相同。
該go指令告訴 Go 應(yīng)該使用哪個(gè)版本的 Go 來(lái)解釋文件。它類(lèi)似于文件中的go指令go.mod 。
該use指令告訴 Go在進(jìn)行構(gòu)建時(shí)hello目錄中的模塊應(yīng)該是主模塊。
所以在模塊的任何子目錄中workspace都會(huì)被激活。
2、運(yùn)行工作區(qū)目錄下的程序
在workspace目錄中，運(yùn)行：
Go 命令包括工作區(qū)中的所有模塊作為主模塊。這允許我們?cè)谀K中引用一個(gè)包，即使在模塊之外。在模塊或工作區(qū)之外運(yùn)行g(shù)o run命令會(huì)導(dǎo)致錯(cuò)誤，因?yàn)樵揼o命令不知道要使用哪些模塊。
接下來(lái)，我們將golang.org/x/example模塊的本地副本添加到工作區(qū)。然后，我們將向stringutil包中添加一個(gè)新函數(shù)，我們可以使用它來(lái)代替Reverse.
在這一步中，我們將下載包含該模塊的 Git 存儲(chǔ)庫(kù)的副本golang.org/x/example，將其添加到工作區(qū)，然后向其中添加一個(gè)我們將從 hello 程序中使用的新函數(shù)。
1、克隆存儲(chǔ)庫(kù)
在工作區(qū)目錄中，運(yùn)行g(shù)it命令來(lái)克隆存儲(chǔ)庫(kù)：
2、將模塊添加到工作區(qū)
該go work use命令將一個(gè)新模塊添加到 go.work 文件中。它現(xiàn)在看起來(lái)像這樣：
該模塊現(xiàn)在包括example.com/hello模塊和 `golang.org/x/example 模塊。
這將允許我們使用我們將在模塊副本中編寫(xiě)的新代碼，而不是使用命令stringutil下載的模塊緩存中的模塊版本。
3、添加新功能。
我們將向golang.org/x/example/stringutil包中添加一個(gè)新函數(shù)以將字符串大寫(xiě)。
將新文件夾添加到workspace/example/stringutil包含以下內(nèi)容的目錄：
4、修改hello程序以使用該功能。
修改workspace/hello/hello.go的內(nèi)容以包含以下內(nèi)容：
從工作區(qū)目錄，運(yùn)行
Go 命令在go.work文件指定的hello目錄中查找命令行中指定的example.com/hello模塊 ，同樣使用go.work文件解析導(dǎo)入golang.org/x/example。
go.work可以用來(lái)代替添加replace 指令以跨多個(gè)模塊工作。
由于這兩個(gè)模塊在同一個(gè)工作區(qū)中，因此很容易在一個(gè)模塊中進(jìn)行更改并在另一個(gè)模塊中使用它。
現(xiàn)在，要正確發(fā)布這些模塊，我們需要發(fā)布golang.org/x/example 模塊，例如在v0.1.0. 這通常通過(guò)在模塊的版本控制存儲(chǔ)庫(kù)上標(biāo)記提交來(lái)完成。發(fā)布完成后，我們可以增加對(duì) golang.org/x/example模塊的要求hello/go.mod：
這樣，該go命令可以正確解析工作區(qū)之外的模塊。
重慶分公司
重慶分公司
