指南

将 Bootstrap 栅格迁移到 Tailwind CSS

把布局从 Bootstrap 的栅格迁移到 Tailwind 需要五个步骤,其中大部分只需一条命令。本指南介绍哪些会变化、类名如何对应,以及脚本无法替你完成的少数几件事。

五步完成迁移

  1. 安装插件

    安装 tw-bootstrap-grid,并在你的 Tailwind 配置中注册它。安装指南里有适用于 Tailwind v3 和 v4 的代码片段。

  2. 对齐 Bootstrap 的断点(可选)

    如果你希望布局在与之前相同的宽度处切换,请把 Tailwind 的屏幕断点设置为 576、768、992、1200 和 1400px。参见下面的断点。

  3. 重命名类名

    先提交你的工作,然后运行下面的 Perl 命令。它会重新编号 gutter,并把 Bootstrap 的 col-md-6 变成 md:col-6。

  4. 修复命令处理不了的部分

    把 mb-3 这样的间距工具类改成 mb-4,把 Bootstrap 的 display 和 flex 工具类换成 Tailwind 的,并替换 container-md 这样的类。

  5. 移除 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

index.html
<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

index.html
<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-6md:col-6Tailwind 把断点放在前面,作为前缀。
col-lglg:col等宽列同样如此。
col-xl-autoxl:col-auto
offset-md-3md:offset-3
row-cols-md-3md:row-cols-3
g-md-4md:g-6数值也会变化,见下面的 gutter 尺寸。
col-xxl-42xl:col-4Bootstrap 的 xxl 在 Tailwind 中叫 2xl。
order-md-2md:order-2order-* 是 Tailwind 自带的,最大到 12。

Gutter 尺寸

Gutter 尺寸
Bootstrap这里尺寸
g-0g-00
g-1g-10.25rem
g-2g-20.5rem
g-3g-41rem
g-4g-61.5rem
g-5g-123rem

来自 Tailwind 的工具类

来自 Tailwind 的工具类
Bootstrap这里说明
d-flexflex
d-none d-md-blockhidden md:block
justify-content-betweenjustify-between
align-items-centeritems-center
align-self-endself-end
mb-3, p-3mb-4, p-4间距工具类的偏移方式与 gutter 相同。

对齐 Bootstrap 的断点

Bootstrap 的断点是 576、768、992、1200 和 1400px。Tailwind 的是 640、768、1024、1280 和 1536px,所以迁移之后布局可能会稍早或稍晚地切换。如果这很重要,请把 Tailwind 的屏幕断点设置成 Bootstrap 的值。

Tailwind v4

main.css
@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。

terminal
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')

只运行一次,并检查结果

再运行一次会再次重新编号 gutter。它也只认识上面这些类名,所以 mb-3 或 p-3 这样的间距工具类需要手动处理,而且这个匹配模式会匹配任何看起来像类名的文本,包括注释里的内容。

不会迁移的内容

插件只添加 .container 和 .container-fluid,所以 Bootstrap 的 .container-sm、.container-md 以及其他响应式容器都不包含在内。如有需要,请用 Tailwind 的 max-w-* 工具类自行搭建。Bootstrap 的其他工具类(display、flex、间距、文本)由 Tailwind 自己的工具类取代,如上面最后一张表所示。

继续阅读