[[394191]]

在前幾天的文章：一日一技：為 Python 項目編寫 Makefile一文中，我們講到了 Makefile。這幾天不少同學在公眾號后臺留言，想進一步了解如何編寫 Makefile。于是，就有了今天這篇文章。

如果你現在使用 macOS 或者 Linux，那么你可以在終端輸入命令man make，查看make命令的幫助文檔，如下圖所示：

通過make命令，你可以快速運行一大段 Shell 命令，從而實現一鍵編譯代碼，一鍵格式化代碼等等功能。

要學習 Makefile，你需要有一個Linux 或者 macOS，然后需要知道兩個概念：make命令和Makefile文件。其中，Makefile文件是你自己寫的一個文本文件，它的名字叫做Makefile，不能修改大小寫，只能叫這個名字。而make是 macOS 和 Linux 中自帶的一個命令。當我們執行make命令的時候，它自動讀取Makefile文件，從而決定自己要做什么事情。

我們來看一個實際例子。下圖為一段很簡單的 Golang 代碼：

代碼里面，有一些逗號后面沒有空格，結構體也寫得參差不齊。當我們要格式化一個.go文件的時候，一般是在當前文件夾下面執行命令：

gofmt -w xxx.go 

運行以后，如下圖所示：

你為了執行這個命令，你需要敲15次鍵盤。而且如果你的項目里面有很多個.go文件，并且他們位于不同的文件夾里面，那么你還需要執行命令：

find . -name "*.go" | xargs gofmt -w 

要敲的鍵盤就更多了。

這個時候，我們可以在項目根目錄創建一個Makefile文件，其內容如下：

fmt: 
 find . -name "*.go" | xargs gofmt -w 

如下圖所示：

于是，當我們在項目根目錄執行命令：make fmt的時候，整個項目里面的所有.go文件都會被自動格式化。

Makefile文件的格式如下：

名字1: 
 shell 命令1 
 shell 命令2 
 shell 命令3 
名字2: 
 shell 命令4 
 shell 命令5 
 shell 命令6 

其中，名字1 名字2用于執行命令make 名字，每一個名字下面可以跟很多條 Shell 命令。這里看起來有點像是 Python 的縮進。但需要特別注意的是，Makefile 的縮進只能使用 Tab 鍵，不能使用空格。

我們再來舉個例子，現在，我需要把項目編譯生成一個可執行文件，然后把這個可執行文件連同data.json一起復制到 一個叫做 output 的文件夾中。那么，我們的 Makefile 可以這樣寫：

fmt: 
 gofmt -w *.go 
 
build: 
 rm -rf output 
 mkdir output 
 go build -o JsonReader main.go 
 mv JsonReader ./output/ 
 cp data.json ./output/ 

然后，當我們執行命令make build的時候，它下面的5行命令就一次性自動執行了。

再來一個例子，可能有一些程序開發完成以后，需要在本地 Docker 環境里面運行。但是如果已經有一個同名容器在運行了，我們必須先停止容器，刪除容器，然后才能重新運行。但是如果有了 Makefile，這也就是一行命令的事情：

deploy: 
 docker build -t xxx:latest 
 docker stop json_reader 
 docker rm json_reader 
 docker run --name json_reader --network host -d xxx:latest 

除此之外，Makefile 還支持串聯多個名字下面的 shell 命令。例如，我想先格式化代碼，然后編譯成可執行文件，最后再使用 Docker 部署，那么，我們最終的 Makefile 文件如下圖所示：

此時，我只需要在項目根目錄中執行命令make，不帶任何參數，那么，fmt、build和deploy下面的所有 Shell 命令都會按順序依次執行。從而大大減少了我們的工作量。

可以說，無論是 Golang 項目還是 Python 還是其他項目，使用 Makefile 來自動化執行一些繁瑣重復的命令，是一個一勞永逸的事情。

本文轉載自微信公眾號「未聞Code」，可以通過以下二維碼關注。轉載本文請聯系未聞Code公眾號。