旧版浏览器(IE11、Edge 12–18、Safari 12–14)完全不解析var()语法,将其视为非法token而整行丢弃;必须采用“静态值在前、var()在后”的同规则内降级写法,且复合属性需拆分为原子属性,PostCSS构建后若残留var(--,说明降级未生效。

旧版浏览器根本不会解析 var() 语法
IE11、Edge 12–18、Safari 12–14 等浏览器使用的是未实现 CSS Custom Properties 规范的内核,var(--x) 对它们而言不是“不支持的特性”,而是非法 token。遇到 color: var(--text); 这样的声明,CSS 解析器直接报错并跳过整行,连括号里的内容都不会尝试读取——所以 var(--x, #000) 的 fallback 参数也完全无效。
color: #000; color: var(--c, #000) 为什么必须这样写?
这是唯一能绕过解析失败的兜底模式,依赖浏览器“逐行解析 + 后声明覆盖前声明”的行为:
- IE/旧 Safari 忽略第二行,用第一行的静态值
- 现代浏览器解析第二行,覆盖第一行
- 顺序不能颠倒:如果写成
color: var(--c, #000); color: #000;,旧浏览器仍忽略第一行,第二行又覆盖了本该生效的值 - 必须在同一 CSS 规则块内,不能跨选择器或文件
复合属性(background、border)为何特别危险?
只要声明中任意位置出现 var(),整条声明都会被丢弃,而不是局部失效:
-
background: #fff url(img.png) no-repeat; background: var(--bg) url(img.png) no-repeat;→ 旧浏览器第二行全失效,背景变成transparent - 正确做法是拆成原子属性:
background-color: #fff; background-color: var(--bg); background-image: url(img.png); -
border: 1px solid #ccc; border: 1px solid var(--border-color);同样不行,必须拆成border-color、border-width单独声明
PostCSS 替换后还有 var(-- 残留,说明什么?
构建产物里搜到任何 var(--,代表降级没生效,常见原因有:
- 变量定义在媒体查询内(如
@media (min-width: 768px) { :root { --gap: 16px; } }),PostCSS 默认不回溯 - 变量值含
calc()或嵌套var(--base),插件无法安全求值 - 变量由 JS 动态注入(如
document.documentElement.style.setProperty('--c', 'red')),构建期不可见 - 跨文件定义但没配
importFrom,插件只看当前文件 - 配置漏了
preserve: false,导致生成了两行但旧浏览器仍读到含var()的那行
最可靠的验证方式:打开构建后的 CSS 文件,全局搜索 var(-- —— 只要还有,就说明某些变量根本没被处理,页面在旧浏览器里必然出问题。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











