必须在main.go中调用carbon.setdefault()，因其全局配置仅首次生效，可防止多goroutine并发触发未配置默认行为导致时间基准漂移。
Carbon 在微服务中不是“拿来即用”的时间工具，它需要明确的时区锚点和配置收敛点，否则各服务实例会因 time.Local 差异或未设默认时区导致时间不一致——这是线上故障最常见的隐形源头。
为什么必须在 main.go 里调用 carbon.SetDefault()
Carbon 的全局配置（如时区、语言、周起始日）只在首次调用 carbon.SetDefault() 时生效，后续调用无效。微服务启动时若多个 goroutine 并发首次使用 carbon.Now()，可能触发未配置的默认行为（v2.6.0 起默认时区是 UTC，但旧版本是 Local），造成时间基准漂移。
- 必须在
main()函数最开始、任何其他 Carbon 调用之前执行 - 推荐写法：
func main() { carbon.SetDefault(carbon.Default{ Timezone: carbon.PRC, // 或 "Asia/Shanghai" Locale: "zh-CN", Layout: carbon.DateTimeLayout, WeekStartsAt: carbon.Monday, }) // 启动 HTTP server / gRPC server 等 } - 避免在中间件、handler 或 init() 中设置——它们可能被多次执行或时机不可控
carbon.Now() 和 carbon.NowInLocation() 的本质区别
carbon.Now() 返回的是「当前进程默认时区」下的时间实例；carbon.NowInLocation("Asia/Shanghai") 是显式加载时区并创建新实例。二者底层都调用 time.LoadLocation()，但前者复用已配置的 DefaultTimezone，后者每次都重新解析字符串。
- 高频调用场景（如日志打点、指标生成）务必用
carbon.Now()，避免重复LoadLocation开销 - 跨时区业务逻辑（如用户所在时区下单时间）才用
carbon.NowInLocation(user.Timezone) - 注意：
carbon.PRC是常量，等价于"Asia/Shanghai"，比字符串更安全（编译期校验）
微服务间时间传递必须用 UTC 时间戳或 ISO8601 字符串
即使所有服务都设了 carbon.PRC，HTTP header、MQ 消息体、数据库字段仍可能被序列化为带本地时区偏移的字符串（如 "2026-07-01T04:07:00+08:00"），下游解析时若未指定时区，carbon.Parse() 可能误判为本地时间。
- API 响应/请求中时间字段统一用
carbon.Now().ToDateTimeString()（含时区）或carbon.Now().Timestamp()（int64 秒级时间戳） - 数据库字段类型优先选
TIMESTAMP WITHOUT TIME ZONE（PostgreSQL）或DATETIME（MySQL），写入前转成 UTC：dbTime := carbon.Now().InLocation("UTC").StdTime() - 绝对不要依赖
carbon.Parse("2026-07-01 04:07:00")这种无时区格式——它默认按time.Local解析，与SetDefault无关
测试环境冻结时间要配合 carbon.Freeze() 和 defer carbon.UnFreeze()
微服务集成测试中，若用 time.Now() 打桩，需修改所有依赖 time 的模块；而 Carbon 提供的 carbon.Freeze() 是全局单例控制，对所有 carbon.Now() 生效，且不影响标准库 time.Now()。
- 单元测试开头冻结：
carbon.Freeze(carbon.New("2026-07-01 00:00:00", "Asia/Shanghai")) - 务必用
defer carbon.UnFreeze()清理，否则影响后续测试用例 - 注意：冻结后
carbon.NowInLocation()仍返回冻结时间 + 目标时区偏移，不是原地转换
真正麻烦的从来不是写几行 carbon.AddDay()，而是当三个服务分别部署在东京、法兰克福、圣保罗，且各自 SetDefault 时机不一致、数据库字段没强制存 UTC、日志时间格式又混用本地化字符串时——问题才会爆发。Carbon 不解决设计问题，只放大配置意图是否清晰。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
