Tailwind 默认不支持 text-shadow 工具类，v3.x 需手动在 theme.extend.textShadow 中配置或使用兼容插件，v4.1+ 才原生支持；任意值语法需严格转义空格为下划线且 content 路径必须覆盖。
Tailwind 默认不提供 text-shadow 工具类，直接写 text-shadow-md 或 text-shadow-lg 会完全无效——不是语法错，是配置根本没加载这个功能。
tailwind.config.js 里没配 textShadow 就别硬写 text-shadow 类
从 Tailwind v3.x 到 v4.0，text-shadow 都不内置；v4.1 起才原生支持，但绝大多数项目仍在用 v3.x。运行 npm list tailwindcss 确认版本，若输出是 3.4.12 这类，就别指望 text-shadow 类能生效。
常见错误现象：text-shadow-sm 写进 HTML 后，开发者工具里查不到 text-shadow 声明，也没任何报错——静默失效。
- 必须在
tailwind.config.js的theme.extend.textShadow下手动定义（注意是extend，不是直接写theme.textShadow） - 插件方式（如
@designbycode/tailwindcss-text-shadow）也得先装包、再加进plugins数组，漏一步都不行 - 别用已归档的
@tailwindcss/text-shadow，它和 v3.3+ 冲突，会导致构建失败
用 arbitrary values 写 text-[...] 时，空格和逗号必须严格转义
临时调试最常用 text-[...]，但 Tailwind 的解析器极敏感：空格会被当分隔符，括号嵌套错位会整条丢弃。
立即学习“前端免费学习笔记（深入）”；
错误写法：text-[0 1px 2px rgba(0,0,0,0.3)]（含空格）、text-[0_1px_2px_rgba(0_0_0_0.3)]（逗号变下划线）
- 所有空格必须替换成下划线
_，括号和逗号保留原样 - 正确写法：
text-[0_1px_2px_rgba(0,0,0,0.3)] - 颜色优先用
rgba()或hsla()，禁用命名色（如black），旧版解析器不认 - 偏移为
0的发光效果，必须写全四值：text-[0_0_4px_hsla(240,100%,70%,0.6)]，缺一个参数就失效
插件 vs 自定义 theme.extend.textShadow：打包体积和复用性差异明显
插件（如 @designbycode/tailwindcss-text-shadow）会在构建时预生成全部阴影规则，哪怕你只用了一次 text-shadow-lg，整个工具集 CSS 都打进 dist；而 theme.extend.textShadow 定义后，仍靠 JIT 按需编译，更轻量。
- 插件适合多处复用、团队统一规范的项目
-
theme.extend.textShadow更可控，可自由增删档位（比如加个xl或none），且不引入额外依赖 - 两者都支持响应式前缀（如
md:text-shadow-lg）和深色模式（dark:text-shadow-md） - 插件默认颜色固定（如
rgba(0,0,0,0.3)），真要换色，还得靠theme.extend.textShadow覆盖或继续用 arbitrary values
文字阴影在深色背景或小字号下容易“看不见”
不是代码没生效，而是对比度崩塌或像素级模糊被 Retina 屏吃掉。
- 深色背景上别用
rgba(0,0,0,0.3)，换成浅色带 alpha 的hsla(0,0%,100%,0.2)或rgba(255,255,255,0.15) - 字体小于
text-sm（14px）时，1px模糊层在高分屏上可能不可见，建议起手用2px - 发光类多层叠加（如霓虹效果）必须跳档模糊：
1px → 2px → 4px → 8px，线性递增（2px → 3px → 4px）会视觉塌层 - 性能隐患：大段正文或密集列表项慎用，低配设备重绘略慢
最常被忽略的一点：任意值语法 text-[...] 必须确保 tailwind.config.js 中 content 字段正确扫描到该文件，否则连 JIT 都不会生成对应 CSS 规则。
