Go 语言：Gocron 库详细指南

Go 语言作为一门现代化、高效的编程语言，拥有丰富的生态系统。其中，Gocron 库是一个强大的任务调度库，可以方便地实现定时任务。本博客将深入介绍 Gocron 库的使用，包括安装、基本用法、高级特性等。

1. 安装 Gocron

使用 Go 的包管理工具 go get 安装 Gocron：

go get -u github.com/go-co-op/gocron

2. 导入 Gocron 包

在你的 Go 项目中导入 Gocron 包：

import "github.com/go-co-op/gocron"

3. 基本用法

3.1 创建调度器

s := gocron.NewScheduler(time.UTC)

3.2 添加定时任务

// 每分钟执行一次任务
s.Every(1).Minute().Do(jobFunc)

// 每天的固定时间执行任务
s.Every(1).Day().At("10:30").Do(jobFunc)

3.3 运行调度器

<-s.Start()

4. 任务执行函数

定义任务执行函数 jobFunc：

func jobFunc() {
    fmt.Println("任务执行啦！")
}

5. 高级特性

5.1 任务链

// 任务链
chain := gocron.NewChain()
chain.Do(func() {
    fmt.Println("任务链中的第一个任务")
})

s.Every(2).Seconds().SetTag("custom").Do(func() {
    fmt.Println("每两秒执行一次，带有标签 custom")
}).SetChain(chain)

s.StartAsync()

5.2 任务参数

// 任务参数
s.Every(1).Day().At("10:30").DoWithParams(jobFuncWithParams, "参数1", 2)

// 带有参数的任务执行函数
func jobFuncWithParams(param1 string, param2 int) {
    fmt.Printf("任务执行啦！参数1：%s，参数2：%d\n", param1, param2)
}

6. 定时器停止

// 停止定时器
s.Stop()

7. 完整示例

package main

import (
	"fmt"
	"github.com/go-co-op/gocron"
	"time"
)

func main() {
	// 创建调度器
	s := gocron.NewScheduler(time.UTC)

	// 添加定时任务
	s.Every(1).Minute().Do(jobFunc)
	s.Every(1).Day().At("10:30").Do(jobFuncWithParams)

	// 运行调度器
	<-s.Start()
}

// 任务执行函数
func jobFunc() {
	fmt.Println("任务执行啦！")
}

// 带有参数的任务执行函数
func jobFuncWithParams() {
	fmt.Println("任务执行啦！带有参数")
}

8. 异常处理

在真实应用中，务必进行异常处理：

try {
    // 执行任务
} catch (err) {
    fmt.Println("发生错误：", err)
}

通过以上步骤，你已经学会了使用 Gocron 库在 Go 语言中实现任务调度。这个库简单易用，同时提供了许多高级特性，可以满足各种任务调度的需求。希望这个详细的指南能够帮助你更好地使用 Gocron 库。