以下是一个例子：

# ---------------------下面定义了几个变量---------------------------
# 
# swagger文档生成目录
SWAGGER_GEN_DIR := docs
# swagger文档最终存放目录
TARGET_SWAGGER_DIR := ./pkg/common/swagger/docs
# swagger文档生成命令
SWAGGER_INIT := swag init -g cmd/main.go
# ---------------------------------------------------------------



# ---------------------下面声明了几个目标是伪目标--------------------
#.PHONY是一个特殊标志，指示后面的目标名不依赖于实际存在的文件，而是伪目标。伪目标通常用来执行特定的操作，而不是生成文件。
.PHONY: swagger clean prepare 
# ---------------------------------------------------------------



# ---------------------下面定义了几个目标---------------------------
# swagger为目标，prepare为目标所需的依赖（可以是伪目标或者实际存在的文件），第一个目标为默认目标，可以直接用make命令执行，也可以使用make swagger执行
swagger: prepare
# 命令，需要以Tab字符开头，而不能是空格符。@符号的作用是抑制命令的回显，否则make执行一个命令时，会首先回显到命令到终端，然后再执行。如果不想在命令执行前被打印出来，就在前面加上@符号
    @echo "Generating Swagger Documentation..."
# 变量替换，执行变量存储的命令，如果不想展示命令，可以使用 @$(SWAGGER_INIT)
    $(SWAGGER_INIT)
# 变量替换
    @echo "Moving Swagger Documentation to $(TARGET_SWAGGER_DIR)"
    cp -r $(SWAGGER_GEN_DIR)/* $(TARGET_SWAGGER_DIR)/
    rm -rf $(SWAGGER_GEN_DIR)
    @echo "Swagger documentation moved and updated successfully!"
    
# 定义目标prepare
prepare:
    @echo "Preparing target directory..."
    mkdir -p $(TARGET_SWAGGER_DIR)
    
# 定义目标clean
clean:
    @echo "Cleaning generated Swagger files..."
    rm -rf $(TARGET_SWAGGER_DIR)
    @echo "Clean complete."
# ---------------------------------------------------------------