必须同时设置 color: transparent 和 -webkit-background-clip: text，否则文字不可见或无渐变效果；因浏览器先绘文字色再裁背景，透明色才能透出背景渐变。
必须同时写 color: transparent 和 -webkit-background-clip: text，否则文字要么是空白，要么是纯色——这不是 bug，是渲染层叠逻辑决定的。
为什么只写 background-clip: text 没效果
浏览器默认会先绘制文字颜色（color），再绘制背景；background-clip: text 只是把背景“裁”到字形里，但不透明的文字仍盖在上面。所以必须显式让文字变透明，才能透出背景渐变。
-
color: transparent是首选，兼容性好、语义清晰 -
-webkit-text-fill-color: transparent在极老 Safari（ - 别用
opacity: 0替代——它会让整个元素透明，包括 background - 检查是否被全局样式（如
p { color: #333 }）覆盖，优先用更具体的选择器或提高权重
linear-gradient 方向与文字宽度不匹配怎么办
渐变是按元素盒模型计算的，不是按字符分布。短文字配大角度渐变（如 45deg），容易只看到一种颜色；长标题配水平渐变（90deg），可能颜色过渡太慢。
- 对短文字（如按钮文案），改用
linear-gradient(90deg, #ff6b6b, #4ecdc4)+background-size: 200% 100%，再配合background-position动画实现扫光 - 对长标题，用
linear-gradient(to right, #00c9ff, #92fe9d)更自然，避免角度过大导致色标压缩 - 不要依赖
background-size: 100% 100%——它会让渐变填满整个宽高，文字越短，单色区域越大
Safari 中渐变文字突然变黑/失效
Safari 对 background-clip: text 的合成环境极其敏感，一触发硬件加速就回退。
立即学习“前端免费学习笔记（深入）”；
- 立刻检查并移除：父级或自身用了
transform（含translateZ(0)）、opacity、filter（如drop-shadow()）、will-change - 临时注释掉所有疑似属性，逐个放开测试
- 加降级保护：
@supports (-webkit-background-clip: text) { ... }，否则 fallback 到color: #333 - 确保元素是
display: inline-block或inline-flex，避免块级元素在某些布局下触发意外合成
Firefox 不显示渐变文字？
Firefox 目前（截至 2026 年 9 月）仍不支持 background-clip: text，且无启用开关。这不是配置问题，是标准实现尚未落地。
- 不要尝试加
-moz-background-clip: text——无效，且可能引发解析警告 - 必须提供降级：
color: #222写在渐变规则之前，或用@supports包裹整套渐变逻辑 - 若需全浏览器一致渐变，只能走 SVG
<text>+<linearGradient>路线，但维护成本高、响应式麻烦
最易被忽略的一点：渐变文字不能和 text-shadow 同时生效——Safari 下 shadow 会强制关闭 background-clip: text 渲染路径。要加阴影，得用伪元素模拟。
