• 在服务端模板（如 EJS、Nunjucks）或 Vue/React 的 SSR 阶段，直接输出带 class="skeleton-item" 的结构
• 避免用 display: none 隐藏真实内容再切换，应让骨架和真实内容共存，用 CSS 控制显隐（例如：真实内容加载完后加 loaded 类，配合 opacity: 0 → 1 过渡）
• 骨架元素需有明确宽高，否则可能塌陷；推荐用 aspect-ratio 或固定 height + width，避免依赖内容撑开

CSS 实现骨架动画的关键是 background-image + gradient

纯色块滚动效果廉价且不自然，主流做法是用线性渐变模拟光扫过的效果。CSS 中不能写 JS 变量，所以动画必须基于 background-position 位移实现。

常见错误现象：background: linear-gradient(...) 写对了但没动——因为漏了 background-size 和 animation 配合。

标准写法示例：

.skeleton-item {
  background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
  background-size: 200% 100%;
  animation: loading 1.5s infinite;
}
@keyframes loading {
  0% { background-position: -200% 0; }
  100% { background-position: 200% 0; }
}

响应式骨架屏要匹配真实组件的断点逻辑

一个卡片在桌面端是三列，在移动端变成单列，骨架屏若只按桌面结构写，小屏下会溢出或错位。不能靠媒体查询简单缩放 width，而应复用真实布局的栅格规则。

使用场景举例：用 grid-template-columns: repeat(auto-fit, minmax(300px, 1fr)) 的列表，骨架屏的容器也得套同一套 grid，每个 .skeleton-card 用 min-width: 300px 对齐。

容易踩的坑：

• 在骨架上用 flex-wrap 但没设 flex-basis，导致小屏下子项被强行压缩
• 字体大小用 px 固定，而真实文本用了 rem 或 clamp()，造成高度不一致
• 图标占位用 但没加 viewBox 和 preserveAspectRatio，缩放失真

Vue/React 中避免骨架屏重复渲染或内存泄漏

组件级骨架屏如果用 v-if 或 useState 控制显隐，要注意加载状态管理边界。比如 API 请求失败后没清掉骨架，或请求中多次触发导致多个骨架叠加。

实操建议：

• 把骨架结构写在组件顶层，用单一布尔值 isLoading 控制，不要嵌套在条件分支里反复挂载
• 在 React 中，避免在 useEffect 里无清理地启动定时器模拟加载（如 setTimeout），否则组件卸载后仍执行，可能触发 setState on unmounted component 警告
• 骨架屏本身不用加 key，除非它和真实内容共用同一组 v-for / map 渲染逻辑——此时 key 必须完全一致，否则 Vue/React 会误判为不同节点而重绘