Go 的 time.Now() 直接调用操作系统时钟 API：Linux 用 clock_gettime，Windows 用 GetSystemTimeAsFileTime，macOS 用 mach_absolute_time；UnixMilli() 因毫秒截断必然重复；Parse() 要求输入完全匹配 Layout；Format() 默认输出 UTC 而非本地时间。
Go 的 time.Now() 不是“自己算出来”的时间，而是直接委托给操作系统——没有跨平台统一实现，只有适配层封装。所谓“纳秒级精度”，是接口声明，不是硬件保证。
time.Now() 底层到底调了什么系统 API
Go 运行时在不同平台调用不同的原生系统时钟接口，不经过用户态中间计算：
- Linux 上走
clock_gettime(CLOCK_MONOTONIC, ...)或CLOCK_REALTIME，依赖内核vDSO加速，通常能到微秒甚至纳秒级分辨率 - Windows 上调
GetSystemTimeAsFileTime()，返回 100 纳秒为单位的 FILETIME，但实际抖动常在毫秒级，尤其在虚拟机或老旧硬件上 - macOS 使用
mach_absolute_time()配合转换表，精度较好，但首次调用有轻微延迟 - 所有平台最终都把原始值塞进
time.Time的wall和ext字段，由 Go 运行时做位运算拼接，不经过浮点或字符串中转
UnixMilli() 在高并发下重复的根本原因
毫秒时间戳本质是“对纳秒取整再除以 1e6”，只要两个 goroutine 在同一毫秒窗口内执行 time.Now()，就必然拿到相同 UnixMilli() 值——这不是 bug，是设计使然：
- 单核 CPU 下，调度器可能把多个 goroutine 压进同一个时间片，
Now()调用间隔远小于 1ms - 即使多核，硬件时钟源（如 TSC）在跨核同步时也可能存在几纳秒偏差，被毫秒截断后归零
-
UnixMilli()是无状态纯函数，不带自增、不查序列号、不加锁，无法自我去重 - 想用于 ID 场景？必须组合：比如
atomic.AddUint64(&seq, 1)或rand.Int63()拼接
Parse() 报错 “parsing time xx: extra text” 的真实诱因
这个错误不是格式写错，而是输入字符串比 Layout 多出未被匹配的字符——time.Parse() 要求完全匹配，尾部空格、换行、时区偏移里的冒号缺失，全会触发 panic：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 输入
"2024-05-30T14:30:00+0800"，Layout 却写"2006-01-02T15:04:05Z07:00"→ 冒号缺失导致失败 - 输入
"2024-05-30 14:30:00\n"，Layout 是"2006-01-02 15:04:05"→ 换行符没被消费，报 extra text - 更隐蔽的是时区缩写，如
"CST"在某些系统解析为美国中部时间，而非中国标准时间，建议一律用Z07:00格式或显式ParseInLocation() - 调试技巧：先用
strings.TrimSpace()清理输入，再用len(input)和len(formatted)对比是否长度一致
Format() 输出 UTC 而非本地时间的默认陷阱
time.Time 值自带 loc *Location，但多数构造方式（Unix()、Parse()、UnixMilli()）默认设为 UTC，不是你机器的 Local：
-
t := time.Unix(1717027200, 0)→t.Location().String()返回"UTC"，t.Format("2006-01-02")就是 UTC 时间 -
t.In(time.Local)依赖系统时区配置，在 Docker 容器里常为空或 UTC，生产环境务必用time.LoadLocation("Asia/Shanghai") - 别信
time.Now().Format(...)—— 它输出的是本地时区没错，但前提是你的机器时区设对了；CI/CD 环境几乎全是 UTC，一跑就错 - 最稳做法：所有时间显示前先确认
t.Location()，必要时强制t.In(loc).Format(...)
真正难处理的不是精度数字，而是“你以为它精确，其实它只负责转发；你以为它自动适配，其实它默认 UTC”。时钟永远在底层静默运行，而 time 包只是那扇不透明的窗。
