用 Taskfile 替代 Makefile：基于 Go 的现代化任务编排工具实战指南

# Go 1.18+ 推荐
go install github.com/go-task/task/v3/cmd/task@latest

# 或者 macOS Homebrew
brew install go-task/tap/go-task

version: '3'

tasks:
  default:
    desc: "默认运行的任务"
    cmds:
      - task: hello

  hello:
    desc: "打个招呼"
    cmds:
      - echo "Hello, 挖宝小周带你玩转 Taskfile!"

task
# 输出: Hello, 挖宝小周带你玩转 Taskfile!

task --list
# 可以清晰看到每个 task 的 desc 描述，极其适合新人快速上手项目！

version: '3'

# 自动加载当前目录下的 .env 文件
dotenv: ['.env']

# 全局变量定义
vars:
  APP_NAME: my-go-service
  GIT_COMMIT:
    sh: git rev-parse --short HEAD
  BUILD_TIME:
    sh: date +%Y-%m-%dT%H:%M:%S
  LDFLAGS: "-s -w -X main.Version={{.GIT_COMMIT}} -X main.BuildTime={{.BUILD_TIME}}"

tasks:
  deps:
    desc: "下载并整理 Go 依赖模块"
    cmds:
      - go mod tidy
      - go mod verify

  lint:
    desc: "运行代码静态检查"
    cmds:
      - golangci-lint run ./...

  test:
    desc: "运行单元测试并生成覆盖率报告"
    cmds:
      - go test -v -race -coverprofile=coverage.out ./...
    sources:
      - "**/*.go"
    generates:
      - coverage.out

  build:
    desc: "编译本地二进制文件"
    deps: [deps]
    cmds:
      - echo "正在编译版本 {{.GIT_COMMIT}}..."
      - go build -ldflags "{{.LDFLAGS}}" -o bin/{{.APP_NAME}} ./cmd/main.go
    # 增量构建机制：只要以下文件没改，且产物存在，就不会重复编译！
    sources:
      - "**/*.go"
      - go.mod
      - go.sum
    generates:
      - bin/{{.APP_NAME}}

  build-all:
    desc: "交叉编译全平台产物（并发执行）"
    deps: [deps]
    cmds:
      - GOOS=linux GOARCH=amd64 go build -ldflags "{{.LDFLAGS}}" -o dist/{{.APP_NAME}}-linux-amd64 ./cmd/main.go
      - GOOS=darwin GOARCH=arm64 go build -ldflags "{{.LDFLAGS}}" -o dist/{{.APP_NAME}}-darwin-arm64 ./cmd/main.go
      - GOOS=windows GOARCH=amd64 go build -ldflags "{{.LDFLAGS}}" -o dist/{{.APP_NAME}}-windows-amd64.exe ./cmd/main.go

  clean:
    desc: "清理构建产物"
    cmds:
      - rm -rf bin dist coverage.out

task: Task "build" is up to date

task --watch test