background-image 本身不支持透明度控制，必须用伪元素+rgba覆盖层或linear-gradient渐变层模拟，核心是将透明度作用于覆盖层而非图片本身。
background-image 本身不支持透明度控制，必须用其他方式“模拟”——核心是**不让透明度作用在图片上，而是作用在覆盖层或混合层上**。直接给容器加 opacity 或尝试 background-image: url(...) opacity(0.5) 都会失败或误伤内容。
为什么不能直接给 background-image 设透明度？
CSS 的 background-image 是一个绘制指令，不是独立元素，没有自己的渲染层，更没有 alpha 参数。浏览器不解析 url(...) 后面跟透明度；opacity 是作用于整个盒模型的合成属性，会连带文字、子节点一起变淡；filter: opacity() 同理，且可能触发重绘性能问题。
用伪元素 + rgba 背景色叠加最稳妥
这是兼容性好、语义清晰、子元素完全不受影响的做法。关键在于把图片和“半透效果”拆开：图片当背景，另起一层纯色覆盖并设透明度。
- 父容器设
position: relative，只放内容（文字、按钮等） - 伪元素
::before绝对定位铺满，background-image设图片，再叠一层background-color: rgba(0, 0, 0, var(--bg-overlay-alpha, 0.4)) - 用 CSS 变量统一管理透明度值，比如
--bg-overlay-alpha: 0.4 - 务必加
z-index: -1确保伪元素在内容之下
示例：
.hero {
position: relative;
}
.hero::before {
content: "";
position: absolute;
inset: 0;
background-image: url("bg.jpg");
background-size: cover;
background-color: rgba(0, 0, 0, var(--bg-overlay-alpha, 0.4));
z-index: -1;
}
用 linear-gradient 模拟渐变遮罩更灵活
如果需要的是“顶部淡入/底部淡出”这类非均匀透明效果，linear-gradient 比纯 rgba 更可控，还能和变量配合：
立即学习“前端免费学习笔记（深入）”；
background: linear-gradient(rgba(0,0,0,0), rgba(0,0,0,0.6)), url(bg.jpg)- 把透明度值抽成变量：
--grad-stop-alpha: 0.6，然后写成linear-gradient(rgba(0,0,0,0), rgba(0,0,0,var(--grad-stop-alpha))) - 注意：gradient 必须写在
url()前面，否则会被覆盖 - 这种方式无法单独控制图片区域的透明度，但适合做视觉引导（如文字区留白）
HEX 变量没法直接套进 background-image 透明控制
有人想写 background: rgba(var(--primary), 0.5) url(...) ——这语法根本不存在，浏览器会忽略整条声明。CSS 不支持对 url() 表达式加 alpha，也不支持把 HEX 变量自动转为带透明度的背景图。
- 所有涉及透明度的方案，最终都得落到
background-color、background-blend-mode或伪元素上 - 若项目已用
--bg-dark: #1a1a1a这类 HEX 变量，又想复用它做遮罩，必须先拆解为 RGB 分量（如--bg-dark-rgb: 26, 26, 26），再用于rgba(var(--bg-dark-rgb), var(--alpha)) - 别指望
background-blend-mode替代透明度：它混合的是颜色通道，不是透明度，multiply或overlay效果不可预测，尤其对亮色图容易过曝
