CSS变量不能用于@container条件判断，因规范要求括号内必须为字面量（如480px），var(--bp-sm)属运行时表达式，整条规则被静默丢弃；变量仅可在查询命中后的样式声明中安全使用，且容器须显式设置container-type和contain以确保尺寸可测。
CSS变量无法直接参与@container的条件判断，但能显著提升查询命中后样式的可维护性与动态响应能力——前提是容器本身已满足可测前提。
为什么@container (min-width: var(--bp-sm))会静默失效
浏览器解析@container规则时，括号内只接受字面量数值（如480px）、CSS函数（如em()）或媒体查询语法，不支持变量插值。一旦写成var(--bp-sm)，整条规则被当作无效语法丢弃，控制台无报错，也不触发任何样式计算。
常见误用场景：
- 把断点变量定义在
.card元素上，却在:root下写@container→ 作用域不匹配，变量读不到 - 拼错变量名，比如
--breakpoint-small写成--breakpoint-sm→ fallback不触发，整条规则失效 - 用
calc(var(--bp) + 1px)试图“绕过”限制 → 仍属非法，不被识别
如何让变量真正起效：只在查询命中后的声明块中使用
变量只能安全用于@container大括号内部的样式声明里，例如字体大小、边距、颜色、grid-template-columns等。此时变量已处于生效作用域，且浏览器已完成尺寸判定。
立即学习“前端免费学习笔记（深入）”；
推荐写法：
- 统一在
:root定义断点值：:root { --card-min-wide: 480px; --card-min-full: 640px; } - 硬编码查询条件，但用注释关联变量：
@container (min-width: 480px) { /* matches --card-min-wide */ } - 在命中后用变量控制具体样式：
@container (min-width: 480px) { padding: var(--pad-md, 1rem); font-size: var(--fs-body, 1rem); } - 配合
clamp()做渐进式缩放：font-size: clamp(0.875rem, var(--fs-scale, 1rem), 1.125rem);
容器必须“可测”：漏掉contain: size或container-type就等于没写
仅写@container规则，浏览器根本不会评估任何条件。必须在容器元素上同时设置两个属性：
-
container-type: inline-size（最常用）或container-type: size -
contain: size（最低要求），推荐写成contain: layout style size以避免子项撑破容器导致宽度误判
典型失效场景：
- Flex/Grid 直接子项未设
min-width: 0→ 默认min-width: auto阻止收缩，尺寸不可测 - 容器父级是
display: flex且自身用了flex: 1，但父级没设明确宽度 → 浏览器无法确定“可用 inline-size” - 用了
float、position: absolute或display: inline→ 破坏布局上下文，container-type静默失效
JS动态切换变量时，别指望@container自动重触发
修改--bp-sm的值不会让已生效的@container重新评估——它只在容器尺寸变化（如窗口 resize、内容增删）时由浏览器主动检测。JS改变量只是改了样式声明里的一个值，不等于改变了容器尺寸。
若需联动响应，可行路径有：
- 用
ResizeObserver监听容器尺寸，再手动切换 class 或更新data-属性，靠属性选择器驱动样式 - 将变量作为状态标记：
.card[data-mode="detail"] { @container (min-width: 480px) { ... } }，JS 切换data-mode后，浏览器会重新匹配规则 - 避免在 JS 中频繁更新断点变量；更适合用变量控制查询命中后的表现细节（如
gap、padding、font-size），而非查询逻辑本身
真正难的从来不是写@container，而是让容器尺寸稳定可测——这要求你清楚 Flex/Grid 的尺寸传播边界、contain的隔离层级，以及 DOM 结构是否允许浏览器可靠地测量 inline-size。
