本教程介紹 Go 中多模塊工作區(qū)的基礎(chǔ)知識。使用多模塊工作區(qū)，您可以告訴 Go 命令您正在同時在多個模塊中編寫代碼，并輕松地在這些模塊中構(gòu)建和運行代碼。
公司主營業(yè)務(wù)：成都網(wǎng)站制作、成都做網(wǎng)站、移動網(wǎng)站開發(fā)等業(yè)務(wù)。幫助企業(yè)客戶真正實現(xiàn)互聯(lián)網(wǎng)宣傳，提高企業(yè)的競爭能力。成都創(chuàng)新互聯(lián)是一支青春激揚、勤奮敬業(yè)、活力青春激揚、勤奮敬業(yè)、活力澎湃、和諧高效的團隊。公司秉承以“開放、自由、嚴謹、自律”為核心的企業(yè)文化，感謝他們對我們的高要求，感謝他們從不同領(lǐng)域給我們帶來的挑戰(zhàn)，讓我們激情的團隊有機會用頭腦與智慧不斷的給客戶帶來驚喜。成都創(chuàng)新互聯(lián)推出泰順免費做網(wǎng)站回饋大家。
在本教程中，您將在共享的多模塊工作區(qū)中創(chuàng)建兩個模塊，對這些模塊進行更改，并在構(gòu)建中查看這些更改的結(jié)果。
本教程需要 go1.18 或更高版本。使用go.dev/dl中的鏈接確保您已在 Go 1.18 或更高版本中安裝了 Go 。
首先，為您要編寫的代碼創(chuàng)建一個模塊。
1、打開命令提示符并切換到您的主目錄。
在 Linux 或 Mac 上：
在 Windows 上：
2、在命令提示符下，為您的代碼創(chuàng)建一個名為工作區(qū)的目錄。
3、初始化模塊
我們的示例將創(chuàng)建一個hello依賴于 golang.org/x/example 模塊的新模塊。
創(chuàng)建你好模塊：
使用 . 添加對 golang.org/x/example 模塊的依賴項go get。
在 hello 目錄下創(chuàng)建 hello.go，內(nèi)容如下：
現(xiàn)在，運行 hello 程序：
在這一步中，我們將創(chuàng)建一個go.work文件來指定模塊的工作區(qū)。
在workspace目錄中，運行：
該go work init命令告訴為包含目錄中模塊的工作空間go創(chuàng)建一個文件 。go.work./hello
該go命令生成一個go.work如下所示的文件：
該go.work文件的語法與go.mod相同。
該go指令告訴 Go 應(yīng)該使用哪個版本的 Go 來解釋文件。它類似于文件中的go指令go.mod 。
該use指令告訴 Go在進行構(gòu)建時hello目錄中的模塊應(yīng)該是主模塊。
所以在模塊的任何子目錄中workspace都會被激活。
2、運行工作區(qū)目錄下的程序
在workspace目錄中，運行：
Go 命令包括工作區(qū)中的所有模塊作為主模塊。這允許我們在模塊中引用一個包，即使在模塊之外。在模塊或工作區(qū)之外運行g(shù)o run命令會導致錯誤，因為該go命令不知道要使用哪些模塊。
接下來，我們將golang.org/x/example模塊的本地副本添加到工作區(qū)。然后，我們將向stringutil包中添加一個新函數(shù)，我們可以使用它來代替Reverse.
在這一步中，我們將下載包含該模塊的 Git 存儲庫的副本golang.org/x/example，將其添加到工作區(qū)，然后向其中添加一個我們將從 hello 程序中使用的新函數(shù)。
1、克隆存儲庫
在工作區(qū)目錄中，運行g(shù)it命令來克隆存儲庫：
2、將模塊添加到工作區(qū)
該go work use命令將一個新模塊添加到 go.work 文件中。它現(xiàn)在看起來像這樣：
該模塊現(xiàn)在包括example.com/hello模塊和 `golang.org/x/example 模塊。
這將允許我們使用我們將在模塊副本中編寫的新代碼，而不是使用命令stringutil下載的模塊緩存中的模塊版本。
3、添加新功能。
我們將向golang.org/x/example/stringutil包中添加一個新函數(shù)以將字符串大寫。
將新文件夾添加到workspace/example/stringutil包含以下內(nèi)容的目錄：
4、修改hello程序以使用該功能。
修改workspace/hello/hello.go的內(nèi)容以包含以下內(nèi)容：
從工作區(qū)目錄，運行
Go 命令在go.work文件指定的hello目錄中查找命令行中指定的example.com/hello模塊 ，同樣使用go.work文件解析導入golang.org/x/example。
go.work可以用來代替添加replace 指令以跨多個模塊工作。
由于這兩個模塊在同一個工作區(qū)中，因此很容易在一個模塊中進行更改并在另一個模塊中使用它。
現(xiàn)在，要正確發(fā)布這些模塊，我們需要發(fā)布golang.org/x/example 模塊，例如在v0.1.0. 這通常通過在模塊的版本控制存儲庫上標記提交來完成。發(fā)布完成后，我們可以增加對 golang.org/x/example模塊的要求hello/go.mod：
這樣，該go命令可以正確解析工作區(qū)之外的模塊。
具體步驟：
1、去官網(wǎng)下載go1.1.2的tarball,一般下載到tem目錄
2、打開終端cd /usr/local, tar -zxvf go1.1.2.linux-386.tar.gz
將源碼文件解壓縮到/usr/local目錄，如果解壓到其他目錄，需要自己設(shè)置GOROOT
3、安裝gcc工具,因為golang有些功能是使用c寫
sudo apt-get install bison gawk gcc libc6-dev make
4、$ cd go/src，$ ./all.bash
運行bash腳本，如果運行正常會獲得你的操作系統(tǒng)和cpu信息，自動編譯安裝
5、將export PATH=$PATH:/usr/local/go/bin 寫入$HOME/.profile
最后進行測試輸入go version 會顯示go1.1.2 linux/386
package main
import (
"fmt"
"os/exec"
)
func main() {
cmd := exec.Command("/bin/sh", "./exec.sh")
bytes, err := cmd.Output()
if err != nil {
fmt.Println("cmd.Output: ", err)
return
}
fmt.Println(string(bytes))
}
本教程介紹了 Go 中模糊測試的基礎(chǔ)知識。通過模糊測試，隨機數(shù)據(jù)會針對您的測試運行，以嘗試找出漏洞或?qū)е卤罎⒌妮斎?。可以通過模糊測試發(fā)現(xiàn)的一些漏洞示例包括 SQL 注入、緩沖區(qū)溢出、拒絕服務(wù)和跨站點腳本攻擊。
在本教程中，您將為一個簡單的函數(shù)編寫一個模糊測試，運行 go 命令，并調(diào)試和修復代碼中的問題。
首先，為您要編寫的代碼創(chuàng)建一個文件夾。
1、打開命令提示符并切換到您的主目錄。
在 Linux 或 Mac 上：
在 Windows 上：
2、在命令提示符下，為您的代碼創(chuàng)建一個名為 fuzz 的目錄。
3、創(chuàng)建一個模塊來保存您的代碼。
運行g(shù)o mod init命令，為其提供新代碼的模塊路徑。
接下來，您將添加一些簡單的代碼來反轉(zhuǎn)字符串，稍后我們將對其進行模糊測試。
在此步驟中，您將添加一個函數(shù)來反轉(zhuǎn)字符串。
a.使用您的文本編輯器，在 fuzz 目錄中創(chuàng)建一個名為 main.go 的文件。
獨立程序（與庫相反）始終位于 package 中main。
此函數(shù)將接受string，使用byte進行循環(huán) ，并在最后返回反轉(zhuǎn)的字符串。
此函數(shù)將運行一些Reverse操作，然后將輸出打印到命令行。這有助于查看運行中的代碼，并可能有助于調(diào)試。
e.該main函數(shù)使用 fmt 包，因此您需要導入它。
第一行代碼應(yīng)如下所示：
從包含 main.go 的目錄中的命令行，運行代碼。
可以看到原來的字符串，反轉(zhuǎn)它的結(jié)果，然后再反轉(zhuǎn)它的結(jié)果，就相當于原來的了。
現(xiàn)在代碼正在運行，是時候測試它了。
在這一步中，您將為Reverse函數(shù)編寫一個基本的單元測試。
a.使用您的文本編輯器，在 fuzz 目錄中創(chuàng)建一個名為 reverse_test.go 的文件。
b.將以下代碼粘貼到 reverse_test.go 中。
這個簡單的測試將斷言列出的輸入字符串將被正確反轉(zhuǎn)。
使用運行單元測試go test
接下來，您將單元測試更改為模糊測試。
單元測試有局限性，即每個輸入都必須由開發(fā)人員添加到測試中。模糊測試的一個好處是它可以為您的代碼提供輸入，并且可以識別您提出的測試用例沒有達到的邊緣用例。
在本節(jié)中，您將單元測試轉(zhuǎn)換為模糊測試，這樣您就可以用更少的工作生成更多的輸入！
請注意，您可以將單元測試、基準測試和模糊測試保存在同一個 *_test.go 文件中，但對于本示例，您將單元測試轉(zhuǎn)換為模糊測試。
在您的文本編輯器中，將 reverse_test.go 中的單元測試替換為以下模糊測試。
Fuzzing 也有一些限制。在您的單元測試中，您可以預測Reverse函數(shù)的預期輸出，并驗證實際輸出是否滿足這些預期。
例如，在測試用例Reverse("Hello, world")中，單元測試將返回指定為"dlrow ,olleH".
模糊測試時，您無法預測預期輸出，因為您無法控制輸入。
但是，Reverse您可以在模糊測試中驗證函數(shù)的一些屬性。在這個模糊測試中檢查的兩個屬性是：
（1）將字符串反轉(zhuǎn)兩次保留原始值
（2）反轉(zhuǎn)的字符串將其狀態(tài)保留為有效的 UTF-8。
注意單元測試和模糊測試之間的語法差異：
（3）確保新包unicode/utf8已導入。
隨著單元測試轉(zhuǎn)換為模糊測試，是時候再次運行測試了。
a.在不進行模糊測試的情況下運行模糊測試，以確保種子輸入通過。
如果您在該文件中有其他測試，您也可以運行g(shù)o test -run=FuzzReverse，并且您只想運行模糊測試。
b.運行FuzzReverse模糊測試，查看是否有任何隨機生成的字符串輸入會導致失敗。這是使用go test新標志-fuzz執(zhí)行的。
模糊測試時發(fā)生故障，導致問題的輸入被寫入將在下次運行的種子語料庫文件中g(shù)o test，即使沒有-fuzz標志也是如此。要查看導致失敗的輸入，請在文本編輯器中打開寫入 testdata/fuzz/FuzzReverse 目錄的語料庫文件。您的種子語料庫文件可能包含不同的字符串，但格式相同。
語料庫文件的第一行表示編碼版本。以下每一行代表構(gòu)成語料庫條目的每種類型的值。由于 fuzz target 只需要 1 個輸入，因此版本之后只有 1 個值。
c.運行沒有-fuzz標志的go test； 新的失敗種子語料庫條目將被使用：
由于我們的測試失敗，是時候調(diào)試了。
首先要知道什么是腳本，腳本是使用一種特定的描述性語言，依據(jù)一定的格式編寫的可執(zhí)行文件，又稱作宏或批處理文件。
基本上就是程序，大多數(shù)指的是用文本編輯器編寫的文本代碼，然后用編譯器解析這些文本所要表達的意思和執(zhí)行。就好象英語語句，可看作是腳本，翻譯的人就成了解析器。
cobra是一個提供簡單接口來創(chuàng)建強大的現(xiàn)代CLI界面的庫類似git git tools，cobra也是一個應(yīng)用程序，它會生成你的應(yīng)用程序的腳手架來快速開發(fā)基于cobra的應(yīng)用程序
cobra提供：
cobra建立在命令、參數(shù)、標志的結(jié)構(gòu)之上
commands代表動作，args是事物，flags是動作的修飾符
最好的應(yīng)用程序在使用時讀起來就像句子，因此，用戶直觀地知道如何與它們交互
模式如下：APPNAME VERB NOUN --ADJECTIVE. or APPNAME COMMAND ARG --FLAG（APPNAME 動詞 名詞 形容詞 或者 APPNAME 命令 參數(shù) 標志）
一些真實世界的好例子可以更好地說明這一點
kubectl 命令更能體現(xiàn)APPNAME 動詞 名詞 形容詞
如下的例子，server 是command，port是flag
這個命令中，我們告訴git 克隆url
命令是應(yīng)用程序的中心點，應(yīng)用程序支持的每一個交互都包含在一個命令中，命令可以有子命令，也可以運行操作
在上面的例子中，server是命令
更多關(guān)于cobra.Command
flag是一種修改命令行為的方式，cobra支持完全兼容POSIX標志，也支持go flag package，cobra可以定義到子命令上的標志，也可以僅對該命令可用的標志
在上面的命令中，port是標志
標志的功能由 pflag library 提供，pflag library是flag標準庫的一個分支，在添加POSIX兼容性的同時維護相同的接口。
使用cobra很簡單，首先，使用go get按照最新版本的庫，這個命令會安裝cobra可執(zhí)行程序以及庫和依賴項
下一步，引入cobra到應(yīng)用程序中
雖然歡迎您提供自己的組織，但通?；贑obra的應(yīng)用程序?qū)⒆裱韵陆M織結(jié)構(gòu)：
在Cobra應(yīng)用程序中，main.go文件通常非常簡單。它有一個目的：初始化Cobra。
使用cobra生成器
cobra提供了程序用來創(chuàng)建你的應(yīng)用程序然后添加你想添加的命令，這是將cobra引入應(yīng)用程序最簡單的方式
這兒 你可以發(fā)現(xiàn)關(guān)于cobra的更多信息
要手動實現(xiàn)cobra，需要創(chuàng)建一個main.go 和rootCmd文件，可以根據(jù)需要提供其他命令
Cobra不需要任何特殊的構(gòu)造器。只需創(chuàng)建命令。
理想情況下，您可以將其放在app/cmd/root.go中：
在init（）函數(shù)中定義標志和處理配置
例子如下，cmd/root.go:
創(chuàng)建main.go
使用root命令，您需要讓主函數(shù)執(zhí)行它。為清楚起見，Execute應(yīng)該在根目錄下運行，盡管它可以在任何命令上調(diào)用。
在Cobra應(yīng)用程序中，main.go文件通常非常簡單。它有一個目的：初始化Cobra。
可以定義其他命令，通常每個命令在cmd/目錄中都有自己的文件。
如果要創(chuàng)建版本命令，可以創(chuàng)建cmd/version.go并用以下內(nèi)容填充它：
如果希望將錯誤返回給命令的調(diào)用者，可以使用RunE。
然后可以在execute函數(shù)調(diào)用中捕獲錯誤。
標志提供修飾符來控制操作命令的操作方式。
由于標志是在不同的位置定義和使用的，因此我們需要在外部定義一個具有正確作用域的變量來分配要使用的標志。
有兩種不同的方法來分配標志。
標志可以是“持久”的，這意味著該標志將可用于分配給它的命令以及該命令下的每個命令。對于全局標志，在根上指定一個標志作為持久標志。
也可以在本地分配一個標志，該標志只應(yīng)用于該特定命令。
默認情況下，Cobra只解析目標命令上的本地標志，而忽略父命令上的任何本地標志。通過啟用Command.TraverseChildren，Cobra將在執(zhí)行目標命令之前解析每個命令上的本地標志。
使用viper綁定標志
在本例中，持久標志author與viper綁定。注意：當用戶未提供--author標志時，變量author將不會設(shè)置為config中的值。
更多關(guān)于 viper的文檔
Flags默認是可選的，如果希望命令在未設(shè)置標志時報告錯誤，請根據(jù)需要進行標記：
持久性Flags
可以使用命令的Args字段指定位置參數(shù)的驗證。
內(nèi)置了以下驗證器：
在下面的示例中，我們定義了三個命令。兩個是頂級命令，一個（cmdTimes）是頂級命令之一的子命令。在這種情況下，根是不可執(zhí)行的，這意味著需要一個子命令。這是通過不為“rootCmd”提供“Run”來實現(xiàn)的。
我們只為一個命令定義了一個標志。
有關(guān)標志的更多文檔，請訪問
對于一個更完整的例子更大的應(yīng)用程序，請檢查 Hugo 。
當您有子命令時，Cobra會自動將help命令添加到應(yīng)用程序中。當用戶運行“應(yīng)用程序幫助”時，將調(diào)用此函數(shù)。此外，help還支持所有其他命令作為輸入。例如，您有一個名為“create”的命令，沒有任何附加配置；調(diào)用“app help create”時，Cobra將起作用。每個命令都會自動添加“-help”標志。
以下輸出由Cobra自動生成。除了命令和標志定義之外，不需要任何東西。
幫助就像其他命令一樣。它周圍沒有特殊的邏輯或行為。事實上，你可以提供你想提供的。
您可以為默認命令提供自己的幫助命令或模板，以用于以下功能：
當用戶提供無效的標志或無效的命令時，Cobra通過向用戶顯示“用法”來響應(yīng)。
你可以從上面的幫助中認識到這一點。這是因為默認幫助將用法作為其輸出的一部分嵌入。
您可以提供自己的使用函數(shù)或模板供Cobra使用。與幫助一樣，函數(shù)和模板也可以通過公共方法重寫：
如果在root命令上設(shè)置了version字段，Cobra會添加一個頂級的'--version'標志。運行帶有“-version”標志的應(yīng)用程序?qū)⑹褂冒姹灸０鍖姹敬蛴〉綐藴瘦敵??？梢允褂胏md.SetVersionTemplate（s string）函數(shù)自定義模板。
可以在命令的主運行函數(shù)之前或之后運行函數(shù)。PersistentPreRun和PreRun函數(shù)將在運行之前執(zhí)行。PersistentPostRun和PostRun將在運行后執(zhí)行。如果子函數(shù)不聲明自己的函數(shù)，則它們將繼承Persistent*Run函數(shù)。這些函數(shù)按以下順序運行：
輸出：
當發(fā)生“未知命令”錯誤時，Cobra將打印自動建議。這使得Cobra在發(fā)生拼寫錯誤時的行為類似于git命令。例如：
基于注冊的每個子命令和Levenshtein距離的實現(xiàn)，建議是自動的。匹配最小距離2（忽略大小寫）的每個已注冊命令都將顯示為建議。
如果需要在命令中禁用建議或調(diào)整字符串距離，請使用：
or
您還可以使用SuggestFor屬性顯式設(shè)置將為其建議給定命令的名稱。這允許對在字符串距離方面不接近的字符串提供建議，但在您的一組命令中是有意義的，并且對于某些您不需要別名的字符串。例子：
Cobra可以基于子命令、標志等生成文檔。請在 docs generation文檔 中閱讀更多關(guān)于它的信息。
Cobra可以為以下shell生成shell完成文件：bash、zsh、fish、PowerShell。如果您在命令中添加更多信息，這些補全功能將非常強大和靈活。在 Shell Completions 中閱讀更多關(guān)于它的信息。
Cobra is released under the Apache 2.0 license. See LICENSE.txt
重慶分公司
重慶分公司
