如何编写适用于Go项目的Makefile

【导读】本文是一篇 Go 项目的 Makefile 指南。

本文章的主题是: 编写适用于 Go 项目的 Makefile 指南。

1. 前提：

• 会使用 Makefile
• 会使用 Go 编写项目

编写项目的过程中，经常需要对文件进行编译和执行，查看功能开发或者修复的 Bug 是否正确。你当然可以直接执行 go build 命令用来编译，执行 go run

命令来执行。

在编写 Go 项目其实还会经常执行些诸如 测试、格式检查、库下载安装等命令。

当然你也可以编写 shell 脚本来执行这些命令，进一步进行了简化。

其实有更好的选择，即 Makefile。在诸多的开源项目中经常能看到 Makefile 的身影。当你的项目中文件发生变化，都可以使用 Makefile 执行命令来自动构建

2. Makefile 语法

PROJECT="example"

default:
echo${PROJECT}

install:
@govendorsync-v

test:install
@gotest./...

.PHONY:defaultinstalltest

上文是一个非常简单的 Makefile 文件，通过这些命令的编写，直接执行 make , make install, make test 等就能完成对应的命令。

格式介绍：

:
[tab]

• target : 即自定义的想要执行的命令
• prerequisites: 前置条件，即执行 target 命令之前执行的命令
• commands : 具体的执行的命令
• .PHONY 伪指令，内置的关键字
• 不带参数，默认执行第一个 target
• @ 表示禁止回声，即终端不会打印真实的执行命令
• # 表示注释
• ${val} 表示变量，和 shell 脚本中的变量的声明和使用一致
• 允许使用 通配符

3. Go 项目

Go 中支持内置的 go 命令，可以用来执行：测试、编译、运行、语法检查等命令

一个完善的 Go 项目经常会执行哪些命令？

• go vet 静态检查
• go test 运行单元测试
• go fmt 格式化
• go build 编译
• go run 运行...

所以一个适用于 Go 项目的 Makefile 也应该支持这些命令。

• make default : 编译
• make fmt: 格式化
• make vet: 静态检查
• make test: 运行测试
• make install: 下载依赖库
• make clean: 移除编译的二进制文件

所以整体可以如下安排：

BINARY="example"
VERSION=1.0.0
BUILD=`date+%FT%T%z`

PACKAGES=`golist./...|grep-v/vendor/`
VETPACKAGES=`golist./...|grep-v/vendor/|grep-v/examples/`
GOFILES=`find.-name"*.go"-typef-not-path"./vendor/*"`

default:
@gobuild-o${BINARY}-tags=jsoniter

list:
@echo${PACKAGES}
@echo${VETPACKAGES}
@echo${GOFILES}

fmt:
@gofmt-s-w${GOFILES}

fmt-check:
@diff=?(gofmt-s-d$(GOFILES));
if[-n"$$diff"];then
echo"Pleaserun'makefmt'andcommittheresult:";
echo"$${diff}";
exit1;
fi;

install:
@govendorsync-v

test:
@gotest-cpu=1,2,4-v-tagsintegration./...

vet:
@govet$(VETPACKAGES)

docker:
@dockerbuild-twuxiaoxiaoshen/example:latest.

clean:
@if[-f${BINARY}];thenrm${BINARY};fi

.PHONY:defaultfmtfmt-checkinstalltestvetdockerclean

4. 补充

Makefile 构建工具，大大的简化了构建项目的难度。

真实的生产环境下，需要使用到CI/CD（持续集成和持续部署）， 所以 Makefile 也通常用来和 CI 工具配合使用。

比如新合并的代码，先触发单元测试，静态检查等，在执行 CI 脚本，成功之后，再构建镜像，推送镜像到服务器上，完成持续集成和持续部署一整套流程。

Makefile 通常配合 travis 使用。

比如：

language:go
go:
-"1.11"
-"1.11.x"
env:
-GO111MODULE=on
notifications:
email:
recipients:
[e-mail]
on_success:change#default:change
on_failure:always#default:always

before_install:
-gotest-cpu=1,2,4-v-tagsintegration./...
-govet$(golist./...|grep-v/vendor/)

script:
-makefmt
-makefmt-check
-makevet
-makelist
-gotest-race./...-coverprofile=coverage.txt-covermode=atomic

希望对大家有所启发。

原文标题：适用于 Go 项目的 Makefile 指南

文章出处：【微信公众号：Linux爱好者】欢迎添加关注！文章转载请注明出处。

审核编辑：汤梓红