使用Go module和GoLand初始化一个Go项目的方法

1 简介

Golang 是一门优秀的语言，特别是在并发编程上，得益于它的协程和 channel 等，非常方便易用。它通过 go module 来管理包和依赖，本文介绍如何利用它创建一个项目。

2 重要的环境变量

Go 通过环境变量来做项目上的管理和控制，通过命令 go env 可以查看相关变量：

$ go env
GO111MODULE="on"
GOARCH="amd64"
GOHOSTOS="darwin"
GOMODCACHE="/Users/larry/go/pkg/mod"
GOPATH="/Users/larry/go"
GOPROXY="https://mirrors.aliyun.com/goproxy/"
GOROOT="/Users/larry/Software/go"
GOTOOLDIR="/Users/larry/Software/go/pkg/tool/darwin_amd64"
GCCGO="gccgo"
CC="clang"
CXX="clang++"
CGO_ENABLED="1"
PKG_CONFIG="pkg-config"

关键环境变量：

GOROOT ： Go 的安装目录，即可执行文件所在的目录；

GOPATH ：工作目录并不是项目所有目录，编译后的二进制文件存放地， import 包的搜索路径，主要包含 bin 、 pkg 、 src ；

GO111MODULE ：启用 go module 管理项目，需要有 go.mod 和 go.sum 文件；

GOPROXY ：下载依赖时的代理，必须配置，不然无法成功下载；

常用的代理有：

# 1. 七牛 CDN
export GOPROXY=https://goproxy.cn,direct

# 2. 阿里云
export GOPROXY=https://mirrors.aliyun.com/goproxy/,direct

# 3. 官方
export GOPROXY=https://goproxy.io,direct

个人用阿里云比较多。

3 初始化项目

用命令执行如下：

# 创建project的目录
$ mkdir pkslow_test
# 进入目录
$ cd pkslow_test/
# 初始化
$ go mod init pkslow.com/pkslow_test
go: creating new go.mod: module pkslow.com/pkslow_test

$ l
-rw-r--r-- 1 larry staff 39 Dec 13 21:07 go.mod
#查看文件内容
$ cat go.mod
module pkslow.com/pkslow_test

go 1.15

新建文件 main.go ，开始写代码：

package main
import "fmt"
func main() {
fmt.Println("hello pkslow")
}

执行或编译后执行：

# 直接run
$ go run main.go
hello pkslow

# 编译成二进制文件
$ go build
t$ l
-rw-r--r-- 1 larry staff 39 Dec 13 21:07 go.mod
-rw-r--r-- 1 larry staff 74 Dec 13 21:12 main.go
-rwxr-xr-x 1 larry staff 2146904 Dec 13 21:12 pkslow_test
# 执行二进制文件
$ ./pkslow_test
hello pkslow

4 引入本地包

创建目录与文件结构如下：

$ tree
├── go.mod
├── main.go
└── mylog
└── pkslow_log.go

新建 pkslow_log.go 的内容如下：

package mylog
import "fmt"

func PkslowLog(str string) {
fmt.Println(str)
}

修改后的 main.go 的内容如下：

package main
import (
"fmt"
"pkslow.com/pkslow_test/mylog"
)

func main() {
fmt.Println("hello pkslow")
mylog.PkslowLog("www.pkslow.com")
}

执行如下：

$ go run main.go
hello pkslow
www.pkslow.com

5 GoLand打开项目

以上已经基本完成了项目的创建，但使用 IDE 写代码会更高效率，直接使用 GoLand 打开项目即可。一些关键配置如下：

GOROOT：

GOPATH：

Go Module：

最终项目整体结构如下：

6 总结

Go 语言还是挺有意思的，值得一试。

来源：https://www.pkslow.com/archives/go-create-project