快捷導航

Go項目的目錄結(jié)構(gòu)詳解

更新時間：2014年10月27日 13:06:55 投稿：junjie

這篇文章主要介紹了Go項目的目錄結(jié)構(gòu),對基礎(chǔ)目錄做了講解,對項目開發(fā)中的其它目錄也一并做了介紹,需要的朋友可以參考下

項目目錄結(jié)構(gòu)如何組織，一般語言都是沒有規(guī)定。但Go語言這方面做了規(guī)定，這樣可以保持一致性。

1、一般的，一個Go項目在GOPATH下，會有如下三個目錄：

|--bin

|--pkg

|--src

其中，bin存放編譯后的可執(zhí)行文件；pkg存放編譯后的包文件；src存放項目源文件。一般，bin和pkg目錄可以不創(chuàng)建，go命令會自動創(chuàng)建（如 go install），只需要創(chuàng)建src目錄即可。

對于pkg目錄，曾經(jīng)有人問：我把Go中的包放入pkg下面，怎么不行?。克苯影袵o包的源文件放入了pkg中。這顯然是不對的。pkg中的文件是Go編譯生成的，而不是手動放進去的。（一般文件后綴.a）

對于src目錄，存放源文件，Go中源文件以包（package）的形式組織。通常，新建一個包就在src目錄中新建一個文件夾。

2、舉例說明

比如：我新建一個項目，test，開始的目錄結(jié)構(gòu)如下：

復(fù)制代碼代碼如下:

test--|--src

為了編譯方便，我在其中增加了一個install文件，目錄結(jié)構(gòu)：

復(fù)制代碼代碼如下:

test/

|-- install

`-- src

其中install的內(nèi)容如下：（linux下）

復(fù)制代碼代碼如下:

#!/usr/bin/env bash

if [ ! -f install ]; then
echo 'install must be run within its container folder' 1>&2
exit 1
fi

CURDIR=`pwd`
OLDGOPATH="$GOPATH"
export GOPATH="$CURDIR"

gofmt -w src

go install test

export GOPATH="$OLDGOPATH"

echo 'finished'

之所以加上這個install，是不用配置GOPATH（避免新增一個GO項目就要往GOPATH中增加一個路徑）

接下來，增加一個包：config和一個main程序。目錄結(jié)構(gòu)如下：

復(fù)制代碼代碼如下:

test

|-- install

`-- src

    |-- config

    |   `-- config.go

    `-- test

        `-- main.go

注意，config.go中的package名稱必須最好和目錄config一致，而文件名可以隨便。main.go表示main包，文件名建議為main.go。（注：不一致時，生成的.a文件名和目錄名一致，這樣，在import 時，應(yīng)該是目錄名，而引用包時，需要包名。例如：目錄為myconfig，包名為config，則生產(chǎn)的靜態(tài)包文件是：myconfig.a，引用該包：import “myconfig”，使用包中成員：config.LoadConfig()）

config.go和main.go的代碼如下：

config.go代碼

復(fù)制代碼代碼如下:

package config

func LoadConfig() {

}

main.go代碼

復(fù)制代碼代碼如下:

package main

import (
"config"
"fmt"
)

func main() {
config.LoadConfig()
fmt.Println("Hello, GO!")
}

接下來，在項目根目錄執(zhí)行./install

這時候的目錄結(jié)構(gòu)為：

復(fù)制代碼代碼如下:

test

|-- bin

|   `-- test

|-- install

|-- pkg

|   `-- linux_amd64

|       `-- config.a

`-- src

    |-- config

    |   `-- config.go

    `-- test

        `-- main.go

  （linux_amd64表示我使用的操作系統(tǒng)和架構(gòu)，你的可能不一樣）

其中config.a是包config編譯后生成的；bin/test是生成的二進制文件

這個時候可以執(zhí)行：bin/test了。會輸出：Hello, GO!

3、補充說明

1）包可以多層目錄，比如：net/http包，表示源文件在src/net/http目錄下面，不過源文件中的包名是最后一個目錄的名字，如http
而在import包時，必須完整的路徑，如：import “net/http”

2）有時候會見到local import（不建議使用），語法類似這樣：

復(fù)制代碼代碼如下:

import “./config”

當代碼中有這樣的語句時，很多時候都會見到類似這樣的錯誤：local import “./config” in non-local package

我所了解的這種導入方式的使用是：當寫一個簡單的測試腳本，想要使用go run命令時，可以使用這種導入方式。
比如上面的例子，把test/main.go移到src目錄中，test目錄刪除，修改main.go中的import “config”為import “./config”，然后可以在src目錄下執(zhí)行：go run main.go

可見，local import不依賴于GOPATH

4、Windows下的install.bat

復(fù)制代碼代碼如下:

@echo off

setlocal

if exist install.bat goto ok
echo install.bat must be run from its folder
goto end

: ok

set OLDGOPATH=%GOPATH%
set GOPATH=%~dp0

gofmt -w src

go install test

:end
echo finished

注,冒號和ok之間不應(yīng)該有空格，但是放在一起總是會被wordpress轉(zhuǎn)成一個表情。汗……