使用 Golang 已经有一阵了，在 Golang 的开发过程中，我已经习惯于不断重复地手动执行 go build 和 go test 这两个命令. 不过，现在我已经摆脱了这个习惯。如果只用到了不带参数的简单命令，直接这么操作可能并不可怕。但是在一些复杂的任务中，如果依旧是手动执行 go build 和 go test ，就可能会成为一个让人头疼的事情。

我们可以通过其他方式解决这个问题。比如，可以用一个 bash 脚本来完成这些工作，或者一个更好的选择（至少对于我来说）是，写一个 makefile. make 这个工具生来就是为了做这些事情，在 makefile 中我们可以将所有常见的任务都放在一起。我并不是一个 makefile 专家，所以可能不太能够教大家如何写一个好的 makefile. 但是在本文，我将向大家展示我所使用的 Makefile，我的大部分项目都使用了这些 makefile 。让我们开始吧：

  1. # Go parameters
  2. GOCMD=go
  3. GOBUILD=$(GOCMD) build
  4. GOCLEAN=$(GOCMD) clean
  5. GOTEST=$(GOCMD) test
  6. GOGET=$(GOCMD) get
  7. BINARY_NAME=mybinary
  8. BINARY_UNIX=$(BINARY_NAME)_unix
  10. all: test build
  11. build:
  12.         $(GOBUILD) -o $(BINARY_NAME) -v
  13. test:
  14.         $(GOTEST) -v ./...
  15. clean:
  16.         $(GOCLEAN)
  17.         rm -f $(BINARY_NAME)
  18.         rm -f $(BINARY_UNIX)
  19. run:
  20.         $(GOBUILD) -o $(BINARY_NAME) -v ./...
  21.         ./$(BINARY_NAME)
  22. deps:
  23.         $(GOGET) github.com/markbates/goth
  24.         $(GOGET) github.com/markbates/pop
  27. # Cross compilation
  28. build-linux:
  29.         CGO_ENABLED=0 GOOS=linux GOARCH=amd64 $(GOBUILD) -o $(BINARY_UNIX) -v
  30. docker-build:
  31.         docker run --rm -it -v "$(GOPATH)":/go -w /go/src/bitbucket.org/rsohlich/makepost golang:latest go build -o "$(BINARY_UNIX)" -v

我比较喜欢 DRY（Don’t Repeat Yourself） 原则。所以，在 makefile 的开头定义常用的命令和变量，我们可以在后面方便地对定义的命令和变量进行引用。

  1. # Basic go commands
  2. GOCMD=go
  3. GOBUILD=$(GOCMD) build
  4. GOCLEAN=$(GOCMD) clean
  5. GOTEST=$(GOCMD) test
  6. GOGET=$(GOCMD) get
  8. # Binary names
  9. BINARY_NAME=mybinary
  10. BINARY_UNIX=$(BINARY_NAME)_unix

在 : 前面的叫做 makefile 的目标，比如 build:, build 就是一个目标。如果在执行 make 命令时指定目标，比如 make run，那么 make 就会构建该目标。如果没有提供任何参数，那么 make 默认会执行第一个目标。在我们的示例中，也就是叫 all 的目标会被构建。

  1. $ make run ## call specific task
  2. $ make     ## make tool calls "all" task

基本命令

makefile 最关键的部分就是构建。当 make 进行执行时，定义的变量会被展开，$(GOBUILD) 会被展开为 go build, **make **实际就会执行 go build 命令。生成的二进制文件被命名为 -o $(BINARY_NAME). 另外，我发现使用 -v 参数切换到 verbose mode 非常有用。在 verbose mode 中，你可以看到当前正在构建的包。

  1. build:
  2.   $(GOBUILD) -o $(BINARY_NAME) -v ## expands to: "go build -o mybinary -v"

因为我们大部分人都很懒，所以就有了一个叫做 **run** 的目标。**run** 会构建二进制文件，并且在 **build** 完成后执行这个二进制文件。

  1. run:
  2.         $(GOBUILD) -o $(BINARY_NAME) -v ./...
  3.         ./$(BINARY_NAME)

通常来讲，**test** 命令应该是 makefile 的一部分。我个人总是喜欢使用 verbose mode 来更好地 debug 和观测 test 的运行。

  1. test:
  2.   $(GOTEST) -v ./...

如果项目使用CI（Continuous Integration）/CD（Continuous Delivery）, 哪怕仅仅是为了一致性，将一系列依赖维护在包里面也是一个非常好的做法。这可以通过 deps 目标来完成，它会通过 go get 命令获取所有相关的依赖。

  1. deps:
  2.         $(GOGET) github.com/markbates/goth
  3.         $(GOGET) github.com/markbates/pop

用 clean 来结束这一节的内容。rm -f 命令被用来移除名为
$(BINARY_XXX) 的二进制文件。

  1. clean:
  2.         $(GOCLEAN)
  3.         rm -f $(BINARY_NAME)
  4.         rm -f $(BINARY_UNIX)

交叉编译命令

如果项目开发是在一个系统上，而需要在另一个系统上运行，那么在 makefile 中包含一个交叉编译的命令是非常方便的。我通常在容器的 Linux 平台上运行二进制，所以 makefile 包含了 Linux 构建。

  1. build-linux:
  2.         CGO_ENABLED=0 GOOS=linux GOARCH=amd64 $(GOBUILD) -o $(BINARY_UNIX) -v

如果你的代码使用了 C binding，你可能会遇到一些问题。CGO 的问题在于你需要一个与给定平台兼容的 gcc。 如果开发在 OSX/Windows 上完成，那么你需要有一个能够兼容 Linux 的 gcc。至少对我来说，在 OSX 上使用配置 gcc 交叉编译 C 代码并不容易。如果需要 CGO, docker 镜像是创建 Linux 构建的最好方式。这种方式唯一的要求就是必须安装 Docker。

  1. ocker-build:
  2.         docker run --rm -it -v "$(GOPATH)":/go -w /go/src/bitbucket.org/rsohlich/makepost golang:latest go build -o "$(BINARY_UNIX)" -v
  1. # Go parameters
  2. GOCMD=go
  3. GOBUILD=$(GOCMD) build
  4. GOCLEAN=$(GOCMD) clean
  5. GOTEST=$(GOCMD) test
  6. GOGET=$(GOCMD) get
  7. BINARY_NAME=mybinary
  8. BINARY_UNIX=$(BINARY_NAME)_unix
  10. all: test build
  11. build: 
  12.         $(GOBUILD) -o $(BINARY_NAME) -v
  13. test: 
  14.         $(GOTEST) -v ./...
  15. clean: 
  16.         $(GOCLEAN)
  17.         rm -f $(BINARY_NAME)
  18.         rm -f $(BINARY_UNIX)
  19. run:
  20.         $(GOBUILD) -o $(BINARY_NAME) -v ./...
  21.         ./$(BINARY_NAME)
  22. deps:
  23.         $(GOGET) github.com/markbates/goth
  24.         $(GOGET) github.com/markbates/pop
  27. # Cross compilation
  28. build-linux:
  29.         CGO_ENABLED=0 GOOS=linux GOARCH=amd64 $(GOBUILD) -o $(BINARY_UNIX) -v
  30. docker-build:
  31.         docker run --rm -it -v "$(GOPATH)":/go -w /go/src/bitbucket.org/rsohlich/makepost golang:latest go build -o "$(BINARY_UNIX)" -v

本文的 Makefile 示例可在 这里 找到。

译者：原文使用的 Makefile 其实还可以更好，比如在原文下面的评论中指出，至少应该指明 .PHONY:, 另外 **build** 应该是 run 的前提条件。不过，我们可以学习其中可取的部分。

译文链接

Golang: Don’t afraid of makefiles


原文

作者：liuchengxu
链接：https://www.jianshu.com/p/88163922edd1
来源：简书
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。