text-fluid类不生效最常见原因是将流体字号错误配置在theme.fontSize顶层，必须置于theme.extend.fontSize下；还需确保content路径覆盖、使用相对单位、显式设置行高、避免断点类冲突，并针对SSR和微信环境做HTML层或JS动态兜底。
直接在 tailwind.config.js 的 theme.extend.fontSize 中配置带 clamp() 的字号值，就能实现移动端按需缩放——但必须写对位置、格式和依赖项，否则类根本不会生成。
为什么 text-fluid 类不生效？
最常见原因是把流体字号写在了错误的配置层级：
- ❌ 错误：写在
theme.fontSize顶层 → Tailwind 完全忽略，也不报错 - ✅ 正确：必须放在
theme.extend.fontSize下，例如：extend: { fontSize: { fluid: ['clamp(1rem, 4vw + 0.8rem, 1.5rem)'] } } - content 配置未覆盖使用该类的文件路径 → JIT 模式不扫描，CSS 不生成
- 用了
px单位（如clamp(16px, ...)）→ Tailwind 不支持非相对单位参与流体计算
如何让流体字号真正适配小屏并保持可读性？
单纯写 clamp() 不够，还需控制最小值基准和行高联动：
- 最小值建议用
1rem（而非0.875rem），避免 iPhone 竖屏下文字过小难辨 - 必须显式传入行高对象：
fluid: ['clamp(1rem, 4vw + 0.8rem, 1.5rem)', { lineHeight: '1.4' }]，否则小屏时行高仍按默认1.5，文字拥挤 - 别混用断点类（如
sm:text-lg text-fluid）→ 后者会被前者覆盖，流体行为失效 - 若容器有
max-w-3xl等限制，vw仍按 viewport 计算，视觉会“撑开”；此时应改用container+width+calc()组合
怎样处理 SSR 或微信大字体等首屏异常？
Tailwind 生成的是静态 CSS，无法感知运行时视口或用户系统设置：
立即学习“前端免费学习笔记（深入）”；
- SSR 渲染时，服务端无
window.innerWidth，首屏字体按最小值渲染 → 需靠 HTML 层兜底，例如： - 微信内置浏览器可能强制放大字号 → 单靠
clamp()无效，需配合WeixinJSBridge监听字体档位并动态调整根font-size -
dir="rtl"切换时，若自定义字体栈含font-family别名，需同步更新 fallback 字体顺序，否则出现字形断裂
真正麻烦的从来不是写对 clamp() 表达式，而是这些运行时上下文缺失带来的首屏错位、多语言排版断裂和第三方环境干预——它们没法靠加一个 class 解决。
