[每周一更]-(第104期)：Go中使用Makefile的经验

在这里插入图片描述

文章目录

- - 1. 项目结构
  - 2. Makefile的基础知识
  - - 什么是 Makefile
  - 3. Go项目的Makefile示例
  - 4. 详细解释每个Makefile目标
  - 5. 使用Makefile执行常见任务

在Go项目中，使用Makefile可以简化和自动化常见的开发和部署任务，如编译、测试、格式化和清理。深入认识及实战。

1. 项目结构

首先，我们假设一个简单的Go项目，其目录结构如下：

my-go-project/
├── Makefile
├── main.go
├── go.mod
├── go.sum
├── pkg/
│   └── example.go
├── cmd/
│   └── myapp/
│       └── main.go
└── test/└── example_test.go

2. Makefile的基础知识

什么是 Makefile

Makefile 是一种配置文件，包含了一系列的规则，用于指导 make 工具如何构建和管理项目。其主要功能包括：

自动化编译源代码
链接目标文件
生成可执行文件
管理文件依赖

在Makefile中，每个任务称为一个“目标”（target），目标可以依赖其他目标。每个目标由依赖和一组命令组成。Makefile的基本语法如下：

target: dependenciescommand

3. Go项目的Makefile示例

以下是一个针对Go项目的Makefile示例：

# Go parameters
GOCMD=go
GOBUILD=$(GOCMD) build
GOCLEAN=$(GOCMD) clean
GOTEST=$(GOCMD) test
GOFMT=$(GOCMD) fmt
GOMOD=$(GOCMD) mod
BINARY_NAME=myapp
BINARY_UNIX=$(BINARY_NAME)_unixall: test buildbuild: $(GOBUILD) -o $(BINARY_NAME) -v ./cmd/myapptest: $(GOTEST) -v ./...clean: $(GOCLEAN)rm -f $(BINARY_NAME)rm -f $(BINARY_UNIX)fmt: $(GOFMT) ./...deps: $(GOMOD) tidyrun: $(GOCMD) run ./cmd/myapp.PHONY: all build test clean fmt deps run

4. 详细解释每个Makefile目标

all: 默认目标，依赖于 test 和 build。运行 make 时会先运行测试，然后构建项目。
build: 编译Go项目，生成可执行文件 myapp。命令 go build -o myapp -v ./cmd/myapp 编译指定目录下的文件。
test: 运行所有测试。命令 go test -v ./... 会递归地运行项目中的所有测试。
clean: 清理编译生成的文件和可执行文件。命令 go clean 会删除编译生成的对象文件，随后删除二进制文件。
fmt: 格式化项目中的所有Go文件。命令 go fmt ./... 会递归地格式化项目中的所有Go源文件。
deps: 管理项目依赖。命令 go mod tidy 会清理并添加缺少的依赖。
run: 运行项目。命令 go run ./cmd/myapp 会编译并运行项目。