time.Duration底层是int64纳秒，不可直接当数字运算；乘系数须用整数或显式float64转换；ParseDuration仅支持毫秒级精度；测时应优先用time.Since()而非UnixNano()差值；JSON/HTTP中推荐用String()序列化。
time.Duration 的底层就是 int64 纳秒，但别直接当数字用
time.Duration 本质是 int64，单位固定为纳秒（1 秒 = 1e9 纳秒），不是“可配置精度”的类型。你写 time.Second、time.Millisecond，它们全都是编译期确定的 int64 常量：time.Second == 1000000000，time.Millisecond == 1000000。
常见错误是把 time.Duration 当普通整数做算术，比如 d := time.Second * 1.5 —— 这会报错，因为 time.Duration 不支持浮点运算；又或者 int64(d) 强转后参与计算，再转回 time.Duration，结果因溢出或截断失真。
- 要乘系数，用整数：
2 * time.Second、500 * time.Millisecond - 要小数倍？先转成 float64 算，再用
time.Duration()显式转回：time.Duration(float64(time.Second) * 1.7)（注意四舍五入截断） - 避免隐式转换：
fmt.Printf("%d", d)打印的是纳秒值，不是“秒”，容易误读
ParseDuration 解析字符串时默认只到毫秒，微秒/纳秒会被丢弃
调用 time.ParseDuration("1.123456s")，返回的是 1123456000 纳秒（即 1.123456 秒 → 1.123 秒），因为 ParseDuration 内部只解析到毫秒级，小数点后最多三位有效，后续数字全部忽略 —— 这不是 bug，是文档明确写的「approximate」行为。
如果你需要更高精度（比如从日志里解析带微秒的时间戳字符串），不能依赖 ParseDuration：
立即学习“go语言免费学习笔记（深入）”；
- 用正则提取数字部分，手动转
float64再乘以1e9得纳秒int64，然后转time.Duration - 或者用
time.Parse配合自定义 layout 解析完整时间点，再用.Sub()推导差值（适用于有起止时间场景） - 注意：即使你构造出纳秒级
time.Duration（如123456789 * time.Nanosecond），在time.Sleep或time.After中，实际调度精度仍受限于 OS 和硬件，Linux 下通常在 10–15ms 量级
time.Now().UnixNano() 和 time.Since() 精度一致，但误差来源不同
time.Now().UnixNano() 返回的是从 Unix epoch 开始的纳秒计数，它本身是高精度的（内核 CLOCK_MONOTONIC 或 CLOCK_REALTIME 支持下可达纳秒级），但要注意：它反映的是系统时钟快慢，可能被 NTP 调整跳变或平滑校准。
time.Since(t) 底层调用的是单调时钟（CLOCK_MONOTONIC），不受系统时间调整影响，适合测耗时，精度也高，但两次调用之间仍存在微小抖动（尤其在容器或虚拟机中）。
- 测函数执行时间，优先用
start := time.Now(); ...; elapsed := time.Since(start) - 不要用
time.Now().UnixNano() - start.UnixNano()替代time.Since()，前者跨时钟源，且可能因系统时间回拨导致负值 - 在要求亚毫秒级稳定性的场景（如高频 tick、实时采样），需考虑 runtime 调度延迟 —— 即使
time.Sleep(1 * time.Microsecond)实际休眠往往远长于此
JSON 和 HTTP header 中序列化 time.Duration 容易丢失精度
time.Duration 没有内置 JSON marshaler，直接 json.Marshal 会输出纳秒整数（如 3000000000），前端或其它服务很难理解这是“3秒”；而用字符串形式（如 "3s"）又得自己实现 MarshalJSON。
HTTP header 更麻烦：w.Header().Set("X-Duration", d.String()) 是安全的，但若用 strconv.FormatInt(int64(d), 10) 就暴露了纳秒细节，下游无法直观还原。
- 对外暴露 duration 时，统一用
d.String()（如"3s"、"500ms"），它自动选最简单位，人眼友好 - 如果必须 JSON 传输且需机器可解析，建议额外字段说明单位，或封装成结构体：
{ "value": 3, "unit": "s" } - 反序列化时，永远用
time.ParseDuration，别尝试strconv.ParseInt后除 1e9 —— 既不兼容字符串输入，又绕过精度截断逻辑
纳秒精度是 time.Duration 的能力边界，不是使用边界。真正卡住你的，往往是 OS 调度、GC STW、容器 cgroup 限频，或者——你忘了 time.Since 才是测时的唯一可信接口。
