不能直接装 Tailwind CSS 就完事：React 项目类型决定集成路径，CRA 需 PostCSS 流程，Vite 推荐 @tailwindcss/vite 插件且版本对齐，Webpack 需配 postcss-loader；content 路径须递归匹配文件后缀，@tailwind 指令必须严格按序置于 CSS 文件顶部。
能不能直接装 tailwindcss 就完事？不能。React 项目类型决定集成路径——create-react-app、自建 Webpack 和 Vite 的配置逻辑完全不同，混用会导致类名不生效、热更新卡死或构建失败。
你用的是 create-react-app 还是 Vite？
这是最关键的分水岭：
-
create-react-app（CRA）项目：必须走 PostCSS 流程，装tailwindcss+postcss+autoprefixer，且不能用@tailwindcss/vite插件（它压根不识别 CRA 的构建链） - 纯 Vite 项目（如
npx create vite@latest --template react创建的）：推荐用@tailwindcss/vite插件，但必须同时安装tailwindcss且版本严格对齐（比如都用 v4.0.x） - 自建 Webpack（比如用
webpack+css-loader+postcss-loader）：只配postcss-loader里的tailwindcss()，别碰 Vite 插件
content 路径写错，Tailwind 就“看不见”你的 JSX
Tailwind 不会自动扫描所有文件，它只按 tailwind.config.js 里 content 字段列出的路径去提取类名。常见错误：
- 写成
["./src/*.{js,jsx}"]→ 漏掉嵌套目录，src/components/Button.jsx里的class="bg-blue-500"直接被忽略 - 没加
.tsx后缀 → TypeScript 项目里类名全丢 - Vite 插件模式下还写
./public/index.html→ Vite 插件不处理 HTML 文件，这个路径白写
正确写法（React + JS）：content: ["./src/**/*.{js,jsx,ts,tsx}"]；Vite 项目可省略 HTML，CRA 项目建议保留。
立即学习“前端免费学习笔记（深入）”；
@tailwind 指令位置错了，样式就全挂
@tailwind base、@tailwind components、@tailwind utilities 必须按顺序、**紧贴顶部**写在主 CSS 文件里（通常是 src/index.css），中间不能插任何其他 CSS 规则或注释。
使用 @ainative/react-sdk 为 React 应用添加 AI 聊天和积分。适用于 (1) 安装 @ainative/react-sdk，(2) 使用 useChat hook 实现聊天完成。
错误示例：
/* src/index.css */
body { margin: 0; }
@tailwind base;
@tailwind components;
@tailwind utilities;
后果：base 层被覆盖，preflight 重置失效，按钮默认边框、列表缩进全乱。
正确写法（开头三行必须干净）：
/* src/index.css */
@tailwind base;
@tailwind components;
@tailwind utilities;
<p>/<em> 后续才能写自定义样式 </em>/
.custom-btn { @apply py-2 px-4 rounded; }
Vite 项目里别再碰 postcss.config.js
用了 @tailwindcss/vite 插件后，postcss.config.js 和 css.postcss.plugins 配置项就该删掉或清空。Vite 插件自己接管了 CSS 处理流程，再塞一个 tailwindcss() 进 PostCSS 链，会触发双重扫描——构建变慢、热更新延迟、甚至某些类名随机消失。
检查点：
-
vite.config.ts里只 import@tailwindcss/vite并加入plugins数组 - 删掉
postcss.config.js文件，或确保它内容为空（module.exports = {};） -
vite.config.ts中不要出现css: { postcss: { plugins: [...] } }这类写法
最常被跳过的环节是 content 路径的递归匹配和 @tailwind 指令的绝对顶部位置——这两个点出问题，整个 Tailwind 就像没装一样，但控制台又不报错，只能靠手动检查文件路径和 CSS 文件头三行。
