Go：如何組織代碼

這是一個建立於 的文章，其中的資訊可能已經有所發展或是發生改變。

原文轉載http://www.cnblogs.com/happyframework/p/3322292.html

Go：如何組織代碼

工作空間（Workspaces）

Go代碼必須保持在一個workspace，workspace是一個目錄結構，他有三個子目錄構成：

1. src：包含了組成packages的原始碼，一個目錄就是一個package。
2. pkg：包含了package objects（編譯後的類庫）。
3. bin：包含了executable commands（編譯後的可執行程式）。

go tool編譯packages，然後將編譯結果安裝到pkg目錄或bin目錄，下面是一個濕樣本：

GOPATH環境變數

GOPATH環境變數指向了Workspace的位置，如果沒有設定的話，自己去設定一下，否則go install會執行失敗。

包路徑（Package Path）

標準類庫的packages可以使用短名字，如：fmt。對於你自己的Packages，最好提供一個base path（基路徑），這可以避免命名衝突，下面是我的命名原則：

1 happygo.codeplex.com/study（原始碼服務提供者倉庫/項目）。

你的第一個程式

選擇一個包路徑

1 happygo.codeplex.com/study/hello

hello.go

package main //command executable（命令列可執行程式）必須使用main作為package名字。


import "fmt"


func main() {
    fmt.Print("你好，世界！\n")
}

項目結構

你的第一個類庫

選擇一個包路徑

1 happygo.codeplex.com/study/hellolib

hellolib.go

package hellolibfunc Max(x int, y int) int {    if x >= y {        return x    }    return y}

修改hello.go，調用類庫

package mainimport (    "fmt"    "happygo.codeplex.com/study/hellolib")func main() {    fmt.Print("你好，世界！\n")    fmt.Printf("2 和 3中最大的是 %d！", hellolib.Max(2, 3))}

項目結構

注意：Go使用靜態連結（會將所依賴的代碼連結到一個檔案）。

包名字（Package Name）

Go源檔案必須以包聲明開始：

1 package name

一些規則：

1. 一個package（檔案件）中的所有檔案必須使用相同的名字。
2. Go語言約定import path（匯入路徑）的最後一個元素是包名字。
3. Executable Commands必須使用 package main。

測試整合

Go提供了 go test 命令和 testing package協助我們做測試，下面是測試的組織規則：

1. 檔案必要以 _test.go 結尾。
2. 函數名必須包含如下籤名：func TestXXX(t *testing.T)。

hellolib_test.go

package hellolib


import "testing"


func TestMax(t *testing.T) {
    const x, y = 2, 3
    max := Max(x, y)
    if max == x {
        t.Error("Max錯誤！")
    }
}