CSS变量无法直接控制repeat()列数是规范限制；可用auto-fit+minmax()实现弹性列数，或JS动态设置gridTemplateColumns。
CSS 变量无法直接控制 repeat() 的列数，这是规范硬限制；但能安全控制 minmax() 阈值、gap、row-gap 和 column-gap —— 想“动态列数”，得换思路。
为什么 repeat(var(--cols), 1fr) 总是不生效
这不是浏览器兼容问题，而是 CSS 解析层拒绝变量作为 repeat() 第一个参数。无论 --cols: 3 还是 --cols: "3"，只要写成 repeat(var(--cols), 1fr)，整条 grid-template-columns 声明就会被静默丢弃。开发者工具的 Computed 面板里该属性为空或显示 initial，且无任何错误提示。
常见踩坑点包括：
-
--cols: 3px或--cols: 3.0—— 带单位或小数，解析失败 -
--cols: "3"—— 引号导致字符串字面量，不是数字 - 用
@property声明类型也绕不过去 —— 所有主流浏览器均未将其接入repeat()参数解析流程
用 auto-fit + minmax() 实现弹性列数
把控制焦点从“固定列数”转向“单列最小宽度”，让 Grid 自动推算列数。CSS 变量可安全用于 minmax() 的第一个参数：
立即学习“前端免费学习笔记（深入）”；
:root {
--grid-min: 280px;
--grid-gap: 1.2rem;
}
.grid-container {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(var(--grid-min), 1fr)));
gap: var(--grid-gap);
}
关键细节：
- 别用
em或rem作--grid-min值 —— 字体缩放可能意外触发换行 -
minmax(0, 1fr)比纯1fr更健壮，防止内容撑爆容器 - 若需多套配置（如卡片列表 vs 数据看板），用不同类名切换变量值，而非堆砌媒体查询
动态修改 gap 必须用 setProperty() 改变量
直接写 element.style.gap = '12px' 会覆盖所有响应式规则，且在 Safari 中动画不触发。可靠做法是抽成变量，再用 JS 控制：
.grid-container {
--grid-gap: 1rem;
gap: var(--grid-gap);
transition: gap 0.2s ease;
}
JS 修改时注意：
- 必须调用
container.style.setProperty('--grid-gap', '12px')—— 单位不能省，传12或'12'无效 - 变量必须定义在
display: grid的直接容器上，不能只靠:root - 检查 computed 样式中
gap是否真为var(--grid-gap)，而不是normal或被其他规则覆盖 - Safari 14.1+ 才完整支持，旧版需 fallback 到分开写：
row-gap: var(--row-gap); column-gap: var(--col-gap)
必须用 JS 动态设置固定列数的场景
当列数来自运行时（如用户偏好、URL 参数、API 返回），且明确要求“就是 N 列”，CSS 层面无解。此时唯一可靠方式是 JS 直接写内联样式：
const n = parseInt(getComputedStyle(document.documentElement).getPropertyValue('--cols').trim(), 10);
if (!isNaN(n)) {
container.style.gridTemplateColumns = `repeat(${n}, 1fr)`;
}
容易忽略的点：
- 务必
trim()并显式parseInt—— 变量值可能带空格或小数 - 避免高频调用 —— 每次设置都触发重排，Grid 计算成本高于 Flex
- 如果多个容器共用同一变量，封装函数传入元素和变量名，别重复查
getComputedStyle
真正难的不是怎么写，而是分清什么时候该放弃 CSS 变量 —— 当需求是“指令式固定列数”，它就不是变量该管的事。
