:root 是 CSS 伪类，匹配文档根元素（HTML 中即 ），是声明 CSS 自定义属性（以 -- 开头）的推荐全局作用域；它本身不是变量，而是提供全局生效的作用域锚点，确保变量可被所有后代继承。
什么是 :root，它真能定义“变量”？
:root 不是 CSS 变量本身，而是伪类选择器，它匹配文档的根元素（在 HTML 中恒为 ）。CSS 自定义属性（即常说的“CSS 变量”）必须声明在某个选择器作用域内，而 :root 是最常用、最稳妥的全局作用域——因为它的优先级低、作用范围最大，且不会被组件化框架意外覆盖。
- 声明必须用
--开头，例如--primary-color: #007bff - 它不支持计算或函数调用（如
calc()需写在使用处，不能放在变量值里） - 浏览器兼容性良好（Chrome 49+、Firefox 31+、Safari 9.1+），IE 完全不支持
怎么写才真正生效？注意声明位置和语法细节
:root 声明必须出现在实际使用前，且不能嵌套在媒体查询、@layer 或其他规则内部（除非你明确想做条件变量）：
:root {
--spacing-xs: 4px;
--spacing-sm: 8px;
--border-radius: 4px;
--shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
}- 不要漏掉分号（最后一个声明后也建议保留，避免后续追加时出错）
- 值中不能有空格环绕冒号（
--color: red合法，但--color : red会失效） - 字符串值需加引号（
--title-font: "Inter", sans-serif），否则空格会被截断
怎么在组件里安全读取和 fallback？
用 var() 函数读取，第二个参数是 fallback（仅当变量未定义或无效时生效）：
Wechat Article Html
下载
将 Markdown 文章转换为微信公众号兼容的纯 HTML 格式。当用户要求"转成微信格式"、"生成公众号文章 HTML"、"排版到微信草稿箱"、"微信粘贴格式"时触发。输出带内联样式的纯 HTML，微信编辑器可直接渲染，无需额外适配。支持标题、段落、列表、粗体、行内代码、表格、引用块、代码块、配图的完整转换。
.button {
background-color: var(--primary-color, #007bff);
padding: var(--spacing-sm) var(--spacing-md, 12px);
border-radius: var(--border-radius);
}- fallback 不支持嵌套
var()（var(--color, var(--fallback))会报错） - fallback 也不能是另一个自定义属性名（如
var(--color, --default-color)不起作用） - 如果变量名拼错（如
var(--primry-color)），且没写 fallback，该声明直接被忽略，不报错也不警告
为什么有时改了 :root 变量，页面没更新？
常见原因不是语法问题，而是：
立即学习“前端免费学习笔记（深入）”；
- 变量被更具体的选择器覆盖（比如某组件写了
.card { --primary-color: #6c757d }，那它内部就看不到:root的值） - JS 动态修改时用了错误方式：
document.documentElement.style.setProperty('--color', 'red')才正确；直接改style.cssText会清空已有变量 - 构建工具（如 PostCSS）启用了 CSS 变量转译，把
var(--x)编译成了静态值，导致运行时无法动态响应
真正要靠 CSS 变量实现主题切换或响应式调整，得确保整个链路都绕过编译期替换，并留意继承与层叠的隐式影响。
