UMI3 中集成 TailwindCSS
创建于:2025-08-08 17:27:44
|
更新于:2025-11-12 15:59:45

注意: UMI4+ 已经内置了 TailwindCSS 支持,只需在 .umirc 中配置即可。本文主要针对 UMI3 项目。

安装依赖

首先安装 TailwindCSS 及其相关依赖:

yarn add -D tailwindcss@3 autoprefixer postcss@8

配置文件

创建 TailwindCSS 样式文件

src/ 目录下创建 tailwind.css 文件:

@tailwind base;
@tailwind components;
@tailwind utilities;

配置 TailwindCSS

创建 tailwind.config.js 配置文件:

/** @type {import('tailwindcss').Config} */
export default {
  mode: 'all',
  content: ['./src/**/*.{js,jsx,tsx}'],
  theme: {
    extend: {},
  },
  plugins: [],
};

配置 UMI

.umirc 文件中添加 PostCSS 插件:

export default {
  extraPostCSSPlugins: [require('tailwindcss'), require('autoprefixer')],
};

引入样式文件

在你的入口页面或全局样式中引入 tailwind.css 文件。

热更新问题及解决方案

配置完成后,你可能会遇到一个问题:修改 TailwindCSS 类名时,样式不会热更新。每次都需要删除 .umi 目录并重新运行项目才能看到效果。

临时解决方案

目前没有完美的解决方案,但可以通过以下方式实现类似热更新的效果:

  1. 单独启动 TailwindCSS 编译进程

package.json 中添加以下脚本:

{
  "scripts": {
    "tw": "tailwindcss -i ./src/tailwind.css -o ./public/output.css --watch",
    "dev": "cross-env APP_TYPE=site umi dev",
    "build": "umi build"
  }
}
  1. 开发时的工作流程
  • 启动两个终端
  • 第一个终端运行:yarn tw(启动 TailwindCSS 监听)
  • 第二个终端运行:yarn dev(启动 UMI 开发服务器)
  • 每次添加新的 CSS 类后,在 tailwind.css 文件中随意保存一下即可触发重新编译
  1. 本地配置覆盖

可以通过 .umirc.local 文件来覆盖本地开发环境的配置,实现更好的开发体验。

总结

虽然在 UMI3 中集成 TailwindCSS 存在热更新的问题,但通过上述配置和工作流程,仍然可以实现相对流畅的开发体验。建议条件允许的情况下升级到 UMI4+,可以享受更好的 TailwindCSS 集成体验。

我也是有底线的 🫠