最稳方案是用 setInterval + Date.now() 计算剩余毫秒，以服务端返回的毫秒级时间戳为基准，每秒更新并判断是否已结束；HTML 用 data-end-time 存时间戳，各数字独立 span 便于动效，需手动 clearInterval 避免内存泄漏。
用 setInterval + Date.now() 算剩余毫秒最稳
直接拿服务端返回的活动结束时间戳（如 1735689600000）和当前时间比，避免本地时间被用户手动篡改导致倒计时错乱。别用 setTimeout 递归，容易因 JS 主线程阻塞累积误差。
关键逻辑是每秒算一次： remaining = endTime - Date.now()，再转成天、时、分、秒。注意 remaining 可能为负，得加判断显示“已结束”。
- 服务端必须返回毫秒级时间戳（不是秒级），否则
new Date(1735689600)会当成 1970 年 - 不要用
new Date().getTime()，Date.now()更简洁且无兼容性问题 - 首次渲染前先算一次，防止页面加载慢导致初始显示为 00:00:00
HTML 结构要预留 class 且避免内联样式
倒计时数字经常要单独控制字体、间距、动画，用 class 比写 style="display: inline-block" 更利于维护。别把时间单位（如“天”“时”）硬编码进 HTML，留空或用 data-unit 属性，方便多语言切换。
<div class="countdown" data-end-time="1735689600000"> <span class="countdown-days"></span><span class="countdown-unit">天</span> <span class="countdown-hours"></span><span class="countdown-unit">时</span> <span class="countdown-minutes"></span><span class="countdown-unit">分</span> <span class="countdown-seconds"></span><span class="countdown-unit">秒</span> </div>
-
data-end-time放在容器上，JS 一次性读取，比每个span都写一遍干净 - 每个数字用独立
span，方便后续加数字翻牌动效（比如用 CSStransform） - 避免用
<time>标签——它语义是“某个时间点”，不是“剩余时长”
倒计时停掉的时机和清理必须手动做
很多人忘了 clearInterval，导致页面隐藏或跳转后定时器还在跑，浪费性能还可能触发错误 DOM 操作。停掉条件不只是 remaining ，还要考虑用户切到其他标签页时 <code>setInterval 可能被浏览器节流，实际间隔变长。
立即学习“前端免费学习笔记（深入）”；
- 每次执行前先检查
remaining ，满足就立刻 <code>clearInterval(timerId)并更新 UI - 监听
visibilitychange事件：页面不可见时暂停计时器，可见时重算剩余时间再恢复，避免误差过大 - 组件销毁（如 React
useEffect清理函数、VuebeforeUnmount）里必须调用clearInterval
服务端时间不准会导致倒计时偏移
如果后端给的时间戳本身有误差（比如用了服务器本地时区没转 UTC，或 NTP 同步不及时），前端再怎么算也没用。上线前务必用 curl 或 Postman 直接请求接口，比对响应里的 end_time 和 curl -I 返回的 Date 头是否一致。
- 推荐后端统一用 UTC 时间戳，前端不做任何时区转换
- 避免用 PHP 的
time()或 Python 的datetime.now().timestamp()，改用datetime.utcnow().timestamp() - 如果必须支持夏令时地区，别依赖客户端
Intl.DateTimeFormat解析，仍以时间戳为准
最麻烦的其实是跨天场景下的“今天 23:59:59 到明天 00:00:00”这种边界，毫秒级计算稍有四舍五入就差一秒，建议所有除法都用 Math.floor，别用 parseInt 或 ~~。
