指南
将 Bootstrap 栅格迁移到 Tailwind CSS
把布局从 Bootstrap 的栅格迁移到 Tailwind 需要五个步骤,其中大部分只需一条命令。本指南介绍哪些会变化、类名如何对应,以及脚本无法替你完成的少数几件事。
五步完成迁移
安装插件
安装 tw-bootstrap-grid,并在你的 Tailwind 配置中注册它。安装指南里有适用于 Tailwind v3 和 v4 的代码片段。
对齐 Bootstrap 的断点(可选)
如果你希望布局在与之前相同的宽度处切换,请把 Tailwind 的屏幕断点设置为 576、768、992、1200 和 1400px。参见下面的断点。
重命名类名
先提交你的工作,然后运行下面的 Perl 命令。它会重新编号 gutter,并把 Bootstrap 的
col-md-6变成md:col-6。修复命令处理不了的部分
把
mb-3这样的间距工具类改成mb-4,把 Bootstrap 的 display 和 flex 工具类换成 Tailwind 的,并替换container-md这样的类。移除 Bootstrap 的 CSS 并检查结果
去掉 Bootstrap 的样式表,然后在手机、平板和桌面宽度下检查你的页面。
哪些会变,哪些不变
保持不变的部分
结构:
.container、.row、.col-*、.offset-*、.row-cols-*。就连 CSS 变量的名字也保持不变,即--bs-gutter-x和--bs-gutter-y,所以读取它们的自定义 CSS 仍然可用。前缀,而不是中缀
Bootstrap 写作
col-md-6,Tailwind 写作md:col-6。这是你改动最多的地方,而一个脚本就可以替你完成。不同的数值
Gutter 和间距的数值遵循 Tailwind 的刻度,所以 Bootstrap 的
g-3在这里是g-4。断点的宽度也略有不同。
同一个布局,迁移前后
Bootstrap 5
<div class="container">
<div class="row g-3">
<div class="col-12 col-md-6 col-lg-4">A</div>
<div class="col-12 col-md-6 col-lg-4">B</div>
<div class="col-12 col-md-12 col-lg-4">C</div>
</div>
</div>tw-bootstrap-grid
<div class="container">
<div class="row g-4">
<div class="col-12 md:col-6 lg:col-4">A</div>
<div class="col-12 md:col-6 lg:col-4">B</div>
<div class="col-12 md:col-12 lg:col-4">C</div>
</div>
</div>类名对照
响应式类名
| Bootstrap | 这里 | 说明 |
|---|---|---|
col-md-6 | md:col-6 | Tailwind 把断点放在前面,作为前缀。 |
col-lg | lg:col | 等宽列同样如此。 |
col-xl-auto | xl:col-auto | |
offset-md-3 | md:offset-3 | |
row-cols-md-3 | md:row-cols-3 | |
g-md-4 | md:g-6 | 数值也会变化,见下面的 gutter 尺寸。 |
col-xxl-4 | 2xl:col-4 | Bootstrap 的 xxl 在 Tailwind 中叫 2xl。 |
order-md-2 | md:order-2 | order-* 是 Tailwind 自带的,最大到 12。 |
Gutter 尺寸
| Bootstrap | 这里 | 尺寸 |
|---|---|---|
g-0 | g-0 | 0 |
g-1 | g-1 | 0.25rem |
g-2 | g-2 | 0.5rem |
g-3 | g-4 | 1rem |
g-4 | g-6 | 1.5rem |
g-5 | g-12 | 3rem |
来自 Tailwind 的工具类
| Bootstrap | 这里 | 说明 |
|---|---|---|
d-flex | flex | |
d-none d-md-block | hidden md:block | |
justify-content-between | justify-between | |
align-items-center | items-center | |
align-self-end | self-end | |
mb-3, p-3 | mb-4, p-4 | 间距工具类的偏移方式与 gutter 相同。 |
对齐 Bootstrap 的断点
Bootstrap 的断点是 576、768、992、1200 和 1400px。Tailwind 的是 640、768、1024、1280 和 1536px,所以迁移之后布局可能会稍早或稍晚地切换。如果这很重要,请把 Tailwind 的屏幕断点设置成 Bootstrap 的值。
Tailwind v4
@import "tailwindcss";
@plugin "tw-bootstrap-grid";
@theme {
--breakpoint-sm: 36rem; /* 576px */
--breakpoint-md: 48rem; /* 768px */
--breakpoint-lg: 62rem; /* 992px */
--breakpoint-xl: 75rem; /* 1200px */
--breakpoint-2xl: 87.5rem; /* 1400px */
}Tailwind 的 container 与它所处的断点一样宽,所以它的最大宽度会变成 576、768、992、1200 和 1400px。这与 Bootstrap 的 540、720、960、1140 和 1320px 很接近,但并不完全相同。
批量重命名
这条 Perl 命令会重新编号 gutter,把 col-md-6 变成 md:col-6,把 col-xxl-4 变成 2xl:col-4,并把旧的 no-gutters 变成 g-0。它会就地改写文件,所以请先提交,之后再查看 diff。
perl -pi -e '
s/\b(g|gx|gy)-((?:sm|md|lg|xl|xxl)-)?([345])\b/"$1-".($2\/\/"").{3=>4,4=>6,5=>12}->{$3}/ge;
s/\bno-gutters\b/g-0/g;
s/\b(col|offset|order|row-cols|g|gx|gy)-(sm|md|lg|xl|xxl)(-([0-9]+|auto|first|last))?\b/$2:$1$3/g;
s/\bxxl:/2xl:/g;
' $(git ls-files '*.html' '*.jsx' '*.tsx' '*.vue' '*.svelte')只运行一次,并检查结果
mb-3 或 p-3 这样的间距工具类需要手动处理,而且这个匹配模式会匹配任何看起来像类名的文本,包括注释里的内容。不会迁移的内容
.container 和 .container-fluid,所以 Bootstrap 的 .container-sm、.container-md 以及其他响应式容器都不包含在内。如有需要,请用 Tailwind 的 max-w-* 工具类自行搭建。Bootstrap 的其他工具类(display、flex、间距、文本)由 Tailwind 自己的工具类取代,如上面最后一张表所示。