go time包默认以utc为基准、强制显式时区参与、time.time是值类型，易致本地时间错乱、跨时区比较失效、格式化异常；须注意time.now()返回本地时间但显示含偏移、docker中可能退化为utc、time.parse默认按utc解析无时区字符串、add与adddate语义不同、比较须用equal()而非==。
Go 的 time 包不是“填上格式就能用”的日期工具，它默认以 UTC 为基准、强制时区显式参与、time.Time 是值类型——这些设计会直接导致本地时间错乱、跨时区比较失效、格式化结果意外等问题。别急着写 time.Now().Format("2006-01-02")，先看清这几个关键点。
time.Now() 返回的是本地时间，但显示容易误导
它返回的是带本地时区信息的 time.Time，但 t.String()（也就是 fmt.Println(t)）固定输出为 "2006-01-02 15:04:05.123456789 +0800 CST" 格式：前半段是本地时刻，后半段是偏移量+时区名。这不是 UTC 时间，只是“UTC 基准 + 本地偏移”的表达方式。
- 要确认当前时区名和偏移，用
t.Location().String()或t.Zone()，而不是靠肉眼读+0800 - 在 Docker 容器里没挂载
/etc/localtime或没设TZ环境变量时，time.Now()会退化为 UTC —— 这是 Go 的预期行为，不是 bug - 日志中建议统一用
t.Format(time.RFC3339)，它自动带时区信息，可读且可被其他系统安全解析
time.Parse 默认把无时区字符串当 UTC 处理
这是最常踩的坑：time.Parse("2006-01-02 15:04:05", "2026-04-05 11:37:00") 解析出来的 time.Time 的 Location() 是 time.UTC，不是你本地时区。你以为是“今天上午”，实际存的是“UTC 时间 2026-04-05 11:37”，和本地时间差 8 小时。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 输入字符串不含时区（如前端传来的纯日期时间），必须用
time.ParseInLocation(layout, s, time.Local) - 如果目标是上海时间，显式加载：
loc, _ := time.LoadLocation("Asia/Shanghai")，再调用time.ParseInLocation(layout, s, loc) - 永远不要对未指定时区的字符串用
time.Parse()后直接比较或入库——它大概率是 UTC，而你认为它是本地时间 - 格式字符串必须严格匹配参考时间，
"2023-01-02"是错的，必须是"2006-01-02"；大小写、空格、标点全都要一致
Add 和 AddDate 语义完全不同
t.Add(24 * time.Hour) 是加 24 小时（86400 秒），纯线性偏移；t.AddDate(0, 0, 1) 才是“加一天”——它感知日历、闰年、夏令时切换（Spring Forward/Fall Back），保证结果是“明天同一时刻”。
- 要算“下个月今天”，用
t.AddDate(0, 1, 0)；用t.Add(720 * time.Hour)在 31 天月份可能跳到错误日期 - 要算“本月第一天”，不能靠减天数推算，而是重建：
time.Date(t.Year(), t.Month(), 1, 0, 0, 0, 0, t.Location()) -
time.Duration不理解日历，只做纳秒加减；所有涉及月、年、星期的运算，必须用AddDate或手动构造time.Date
time.Time 比较必须用 Equal()，不能用 ==
time.Time 是值类型，但内部包含时区指针；两个等价的时间点，如果 Location 不同（比如一个来自 time.Local，一个来自 time.UTC），用 == 会返回 false，即使它们代表同一物理时刻。
- 判断是否相等，一律用
t1.Equal(t2) - 判断先后顺序，用
t1.Before(t2)或t1.After(t2)，它们会自动做时区归一化 - 用
t1.Sub(t2)计算时间差，返回time.Duration，单位是纳秒，可转成秒/分/小时：d.Seconds()、d.Minutes()
真正难的不是记住函数名，而是每一步操作都得问一句：“这个时间点现在绑定的是哪个时区？我接下来的加减、比较、格式化，是否还在同一个上下文里？”时区一旦丢失或错配，后续所有逻辑都会漂移——而且这种漂移往往在跨月、跨年、跨时区部署时才暴露。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
