robfig/cron 直接 import 报错是因为 go 模块系统拒绝加载未声明 major 版本的 v3+ 包，旧路径不兼容 modules 且缺少关键方法，正确方式是显式导入 github.com/robfig/cron/v3。
robfig/cron 已归档不再维护，github.com/robfig/cron 在 Go 1.16+ 中无法正常工作，新项目必须换用 github.com/robfig/cron/v3 或更现代的替代品（如 github.com/hibiken/asynq、github.com/go-co-op/gocron）。
为什么 robfig/cron 直接 import 会报错？
Go 模块系统会拒绝加载未声明 major 版本的 v3+ 包。直接写 import "github.com/robfig/cron" 会拉取 v0/v1 的旧版，而该版本不兼容 Go modules 且缺少 Cron.Start() 等关键方法；若手动指定 v3，又因模块路径未带 /v3 后缀导致解析失败。
- 错误现象：
undefined: cron.New或go: finding module for package github.com/robfig/cron卡住 - 根本原因：作者将 v3+ 迁移至
github.com/robfig/cron/v3，但未做向后兼容重定向 - 正确导入方式必须显式写全路径：
import "github.com/robfig/cron/v3" - go.mod 中对应条目是：
github.com/robfig/cron/v3 v3.0.1（注意末尾/v3）
cron/v3 的基本用法和常见陷阱
v3 版本默认使用 Seconds 级别调度（即支持秒级表达式），但多数人仍习惯用分钟级格式（0 * * * * ?），容易因格式不匹配导致任务不触发。
- 默认 parser 是
cron.Secondly，支持 6 字段（秒 分 时 日 月 周）；若传 5 字段表达式（如"0 0 * * *"），需显式指定cron.WithParser(cron.NewParser(cron.Minute | cron.Hour | cron.Dom | cron.Month | cron.Dow)) -
cron.New()返回的是未启动的实例，必须调用.Start()才真正运行；忘记这步是“写了定时任务却从不执行”的最常见原因 - 任务函数若 panic，v3 默认会捕获并记录日志但不终止 cron 实例——这点和 v1 不同，但也意味着错误可能被静默吞掉
- 示例（每 5 秒打印一次）：
package main <p>import ( "fmt" "time" "github.com/robfig/cron/v3" )</p><p>func main() { c := cron.New() c.AddFunc("@every 5s", func() { fmt.Println("tick", time.Now()) }) c.Start() select {} // 防止主 goroutine 退出 }</p>
如何安全停止 cron/v3 实例？
cron/v3 没有内置的 Graceful Shutdown 支持，直接 kill 进程可能导致正在执行的任务中断，且 c.Stop() 不等待已触发任务完成。
-
c.Stop()仅关闭调度器，不阻塞等待正在运行的 job 结束 - 若任务含 I/O 或长耗时操作，需自行加 context 控制生命周期，例如在
AddFunc中传入可取消的context.Context - 推荐模式：用
sync.WaitGroup+ 闭包变量标记“是否允许新任务启动”，再配合time.AfterFunc延迟退出，确保已有 job 尽力完成 - 不要依赖
defer c.Stop()—— 它在 main return 时才调，而程序可能已提前崩溃或被 SIGTERM 终止
真正难处理的不是怎么写一个定时任务，而是当多个 job 共享状态、需要跨进程协调、或要求精确到毫秒级触发时，cron/v3 的抽象层就显得单薄了。这时候该考虑是否真的需要它，还是直接用 time.Ticker + 自定义调度逻辑更可控。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
