应封装语义意图而非坐标数字，如@include place-in-header；用minmax(0,1fr)防溢出；响应式类须单文件编译；grid-template-areas与自动生成位置类互斥。
直接封装 grid-row-start、grid-column-end 这类属性为「一行调用」Mixin 是危险的——它掩盖了 Grid 的轴向语义，反而让布局更难调试、更易冲突。
别封装坐标数字，封装语义位置
传 @include grid-cell(2, 4, 1, 3) 这种参数顺序没人记得住，而且一旦改设计，所有调用点都要重算。真正该封装的是意图，不是坐标：
-
@include place-in-header：内部统一设grid-area: header或grid-row: 1; grid-column: 1 / -1 -
@include span-full-width：生成grid-column: 1 / -1，不依赖列数硬编码 -
@include align-center-vertically：用grid-row: 2 / 3+justify-self: center组合，而非只动 row 值
语义名即契约，改布局时只需调整 Mixin 内部实现，调用处零修改。
@for 生成列数类时，minmax(0, 1fr) 比 1fr 更安全
纯 1fr 在内容超宽时可能撑破容器，尤其配合 white-space: nowrap 或长链接时。Sass 编译期无法预知内容，但 minmax(0, 1fr) 能强制收缩，避免溢出：
立即学习“前端免费学习笔记（深入）”；
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
@for $i from 1 through $grid-max-columns {
.grid-cols-#{$i} {
grid-template-columns: repeat(#{$i}, minmax(0, 1fr));
}
}注意：.grid-cols-auto 这类非数字类必须单独写，@for 不会覆盖它。
响应式 Grid 类必须在单个文件内完成编译
Sass 的 @media 规则不能跨 @use 文件生效。如果你把断点定义在 _breakpoints.scss，又在 _grid.scss 里 @each 循环生成响应式类，结果就是 CSS 里只有类名，没有包裹的媒体查询——布局直接失效。
- 所有断点变量和
@each+@for逻辑必须放在同一个.scss文件中 - 断点映射用
$breakpoints: ("md": 768px)，别用 px 数字硬编码在循环里 - 生成类名如
.grid-cols-md-6，而非嵌套多层@media导致输出膨胀
grid-template-areas 和自动生成的 .col-start-* 类天然互斥
你写了 grid-template-areas: "header header" "main aside"，再给某个元素加 .col-start-3，后者会被忽略——Grid 优先使用命名区域定位。这类冲突不会报错，但布局静默失效，极难排查。
解决方案只有两个：
- 文档明确标注：「本套 Grid 工具仅适用于显式
grid-column/grid-row定位场景」 - 或彻底放弃自动生成位置类，改用
@include place-in("main")这类基于grid-area的语义封装
Grid 的强大在于组合自由度，强行统一所有路径，只会让最灵活的部分变成最脆弱的环节。
