必须将 $grid-columns 变量声明置于所有 Bootstrap SCSS 导入之前,否则无效;改列数会联动影响 offset- 和 order- 类行为,非因数型列数推荐手动编写轻量自定义类。

改 $grid-columns 变量但没生成新类?顺序和导入路径错了
直接在 @import "bootstrap" 之后写 $grid-columns: 24; 是无效的——变量早已被读取。Bootstrap 5 的栅格类(如 .col-1 到 .col-24)由 bootstrap/scss/grid.scss 中的 @each 循环动态生成,它只认编译时已确定的值。
必须按顺序显式导入,并把变量声明放在最前面:
$grid-columns: 24; @import "bootstrap/scss/functions"; @import "bootstrap/scss/variables"; @import "bootstrap/scss/mixins"; @import "bootstrap/scss/grid";
- 不能用
@import "bootstrap/scss/bootstrap"替代,它内部逻辑可能跳过你的重定义 - 不能只导入
bootstrap.min.css,那是预编译死的 12 列 - 编译后检查输出 CSS 是否含
.col-24或.offset-12,这是唯一可信验证方式
col-md-5 这种类为什么始终不生效?12 列不是“默认”,是硬编码前提
Bootstrap 的预定义类名(.col-md-1~.col-md-12)是 Sass 编译时根据 $grid-columns 值生成的,不是运行时解析。你设 $grid-columns: 5 理论上能生成 .col-1~.col-5,但实际会出问题:
-
.col-md-6依然存在(它是按原 12 列体系生成的),混用会导致宽度冲突:一个算 50%,一个算 100%,Flex 容器直接崩 - 所有响应式断点(
sm/md/lg)都共用同一套列数,无法像 12 列那样自然支持 1/3、1/4、1/6 等常用比例 -
row-cols-5不是替代方案——它只控制每行最多显示几个.col,不改变单列宽度逻辑,也不生成新类
想实现 5 等分或 10 列布局?别碰 $grid-columns,加自定义 class 更稳
对非因数型列数(如 5、7、10),推荐复用 Bootstrap 断点机制,手动写轻量 class:
.col-md-1-5 { width: 20%; flex: 0 0 auto; }
.col-md-2-5 { width: 40%; flex: 0 0 auto; }
@media (min-width: 992px) {
.col-lg-1-5 { width: 20%; flex: 0 0 auto; }
}
- 必须加
flex: 0 0 auto,否则width在.row(Flex 容器)里会被忽略 - 首列要重置
margin-left: 0,否则默认 gutter 会让它错位 - 偏移可用
.col-md-offset-40这类命名(按百分比),避免依赖原生offset-类 - 这类 class 体积小、可控性强,且不干扰原有栅格行为
offset- 和 order- 类的行为会悄悄变,尤其当列数 >12
$grid-columns 不只影响 col-,还联动控制 offset- 的步进单位和 order- 的生成上限:
- 设为 24 后,
.offset-12表示空出 50% 宽度(12/24),不再是原来 12 列下的 100% -
.order-默认生成到$grid-columns + 1,24 列就会有.order-25——多数项目根本用不到,却白白增大 CSS 体积 - 若想限制
order-最大只到 12,Bootstrap 5.3+ 支持提前定义$grid-order-max: 12;(放在@import variables前) -
$grid-gutter-width虽不直接受列数影响,但它的百分比分配逻辑会随列数变化,大屏下间距可能显得突兀
真正容易被忽略的是:列数改得越大,offset- 的“最小可偏移单位”就越小(比如 24 列下 .offset-1 = 4.17%),微调更精细,但也更容易因四舍五入导致像素级错位。


















