应使用语义化CSS变量（如--gap-md: 12px）统一管理Flex间距，配合媒体查询重定义实现响应式，同时为老版Safari添加margin fallback以确保兼容性。
用 --gap CSS 变量定义统一间距基准
直接在 :root 或组件作用域内声明一个变量，比如 --gap: 12px，后续所有 Flex 容器都复用它。这比硬编码 gap: 12px 更易维护，改一处就全局生效。
注意变量名要语义清晰，避免用 --spacing-1 这类模糊命名；推荐按用途分层，例如：--gap-sm: 4px、--gap-md: 12px、--gap-lg: 24px。这样在不同密度场景（如表单控件 vs 卡片列表）中可按需切换。
- 变量必须声明在使用前，否则
gap: var(--gap)会退回到浏览器默认值（通常是0） - 不要在变量值里写单位以外的字符，
--gap: 12px !important是非法的，会失效 - 若项目需兼容 IE，CSS 变量本身不被支持，此时应降级为预处理器变量（如 Sass
$gap-md）或纯 class 命名方案
gap 在 Flex 中只作用于主轴，别误以为它能控制交叉轴
当 flex-direction: row 时，gap: var(--gap-md) 控制的是水平间距；换成 column，它控制的就是垂直间距。Flex 的 gap 永远不会同时影响两个方向——它不是 Grid 那种二维 gap。
常见误解是写 gap: var(--gap-md) var(--gap-sm)，这是无效语法，整条声明会被浏览器忽略。Flex 不支持双值 gap。
立即学习“前端免费学习笔记（深入）”；
- 需要“行+列”都设间距？只能用
row-gap和column-gap分开写，但注意：Flex 中column-gap仅在flex-wrap: wrap且存在多行时才起作用 - 若你发现设置了
gap却没效果，先检查display: flex是否生效，再确认子元素是否为直系后代（gap不作用于嵌套容器内的孙元素）
响应式中动态切换 gap 值要靠媒体查询 + 变量重定义
不能直接在媒体查询里写 gap: var(--gap-sm) 然后指望它自动更新——变量值本身是静态的。正确做法是在不同断点下重新赋值变量：
:root { --gap: 12px; }
@media (max-width: 768px) {
:root { --gap: 8px; }
}
.flex-container { gap: var(--gap); }
这样，小屏下所有用到 --gap 的地方都会同步收缩。如果只希望某个容器单独响应，就把变量声明移到该容器选择器内，而非 :root。
- 别把媒体查询逻辑塞进 JS 里动态改 style，既难调试又破坏 CSS 自然层叠
- 移动端慎用过大的
--gap值（如 > 24px），容易导致内容被挤出视口，尤其在键盘弹出时 - 若用 CSS-in-JS（如 Emotion），确保变量注入顺序正确，避免 SSR 渲染时变量未定义
兼容老版 Safari（≤15.x）必须加 margin fallback
当前（2026 年）Safari 16.4+ 已原生支持 gap，但仍有部分企业内网或教育终端停留在 Safari 15.x。这些环境会完全忽略 gap 声明，导致子元素紧贴在一起。
最稳妥的降级方式是：保留 gap，同时用 :not(:first-child) 给子项加 margin：
.flex-container {
display: flex;
gap: var(--gap);
}
.flex-container > *:not(:first-child) {
margin-left: var(--gap); /* row 方向 */
}
/* column 方向则用 margin-top */
这种写法无需 JS，且现代浏览器会优先使用 gap（它比 margin 更可靠，不参与 margin collapse）。
- 别用
:last-child清 margin，因为 Flex 容器可能动态增删子项，首尾判断不稳定 - 如果子项本身已有
margin-left，和 fallback 的 margin 叠加会导致间距翻倍，此时应统一归零后再加 - Ant Design Mobile 的
Space组件底层就是这么做的：用gap主流程 +margin保底，值得参考
实际项目里最容易被忽略的，是变量作用域和浏览器兼容性之间的隐性冲突——比如你在 :root 设了 --gap，又在组件里用 @supports (gap: 0) 做特性检测，结果 Safari 15.x 既不支持 gap 又读不到变量，fallback 就可能漏掉。这时候得靠构建时的 PostCSS 插件或明确的 class 分层来兜底。
