跳转至

go项目的组织形式

参考Managing module source

一般而言,go项目以module为组织单位,每个module可以有多个package,其中main package是特殊的。

单文件

对于初学者来说,所有的代码都保存在一个文件里即可。

main.go
package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")
}

注意第一行,需要声明package main(只有main package才能运行)。

然后直接运行该文件即可

$ go run main.go
Hello, World!

单module

单package

为了逻辑的分离,我们可以把同一个package的代码分到不同的文件。

和Python不同,在go语言里,文件的名字是无关紧要的。文件所属的package才是至关重要的。

这时候则需要把他们都纳入到同一个module下:

mkdir go_project
cd go_project
# 把当前文件夹初始化为一个module
go mod init hello
# 创建两个 .go 文件
touch main.go
touch hello.go

两个文件的内容分别如下:

hello.go
package main

var hello string = "Hello, World!"
main.go
package main

import "fmt"

func main() {
    fmt.Println(hello)
}

这时候我们就需要go run [文件目录]了:

$ go run .
Hello, World!

多package

当然,也可以分不同的package

例如下面的文件结构(依然,文件的名字不重要):

.
├── add
│   └── main.go
├── constant
│   └── main.go
├── go.mod
└── main
    └── main.go

4 directories, 4 files
add/main.go
package add

func Add(a, b int) int {
    return a + b
}
constant/main.go
package constant

const Hello string = "Hello, World!"
go.mod
module hello

go 1.22.3
main/main.go
package main

import (
    "fmt"
    "hello/add"
    "hello/constant"
)

func main() {
    fmt.Println(add.Add(2, 3))
    fmt.Println(constant.Hello)
}

使用go run ./main即可运行:

$ go run ./main
5
Hello, World!

多module

这时候可以使用workspace来进行开发。

例如如下的文件结构:

.
├── go.work
├── module1
│   ├── go.mod
│   └── main.go
└── module2
    ├── add
    │   └── add.go
    ├── constant
    │   └── hello.go
    └── go.mod

5 directories, 6 files
目录中有两个文件夹,分别是两个module:mod1mod2

go.work文件注明了这个workspace使用到的module:

go.work
go 1.22.3

use (
    ./module1
    ./module2
)

我们在mod1的main.go中调用了mod2的代码:

module1/main.go
package main

import (
    "fmt"
    "mod2/add"
    "mod2/constant"
)

func main() {
    fmt.Println(constant.Hello)
    fmt.Println(add.Add(2, 3))
}

这时候我们可以在workspace的根目录直接运行mod1

$ go run mod1
Hello, World!
5

最后更新: 2024-10-17 11:20:00
创建日期: 2024-10-17 11:20:00

评论