Tailwind 默认不启用 textShadow 工具类，需手动配置插件或使用 arbitrary values；插件方式需安装并注册 @ryano/tailwind-css-text-shadow，arbitrary values 则用下划线替代空格书写完整阴影值。
tailwind.config.js 里没开 textShadow 就别硬写 text-shadow
Tailwind 默认不启用文字阴影工具类，直接写 text-shadow-md 或 text-shadow-lg 会失效——不是你写错了，是配置根本没加载这个插件。官方 @tailwindcss/typography 也不管这事，得手动配。
有两个路子：一是用社区插件 @ryano/tailwind-css-text-shadow，二是靠 arbitrary values（方括号语法）临时加。前者适合项目中多处用、需复用；后者适合单次调试或快速验证。
- 插件方式要改
tailwind.config.js，加plugins: [require('@ryano/tailwind-css-text-shadow')]，再跑npm install @ryano/tailwind-css-text-shadow - arbitrary values 不用装包，但每次都要写完整值，比如
text-[0_1px_2px_rgba(0,0,0,0.3)]，注意空格和引号会被解析器吃掉，必须用下划线代替空格 - 插件默认提供
text-shadow-sm/text-shadow/text-shadow-md/text-shadow-lg四档，对应不同模糊半径和偏移，但颜色固定为rgba(0,0,0,0.3)，真要换色还得覆盖 theme 或继续用 arbitrary
arbitrary values 写 text-[...] 时，值里不能有空格和括号嵌套问题
这是最常卡住的地方：Tailwind 的 arbitrary value 解析器把空格当分隔符，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)]（空格）、text-[0_1px_2px_rgba(0_0_0_0.3)]（错把逗号当下划线）。
立即学习“前端免费学习笔记（深入）”；
- 水平偏移、垂直偏移、模糊半径、颜色四个部分缺一不可，顺序也不能乱
- 颜色推荐用
rgba()或十六进制带 alpha（如#0008），hsl()也行，但别用命名色（black）——有些版本不支持 - 如果只想要阴影不想要偏移，写成
text-[0_0_4px_rgba(0,0,0,0.2)]，别省略前两个零
插件生成的 class 和 arbitrary values 在 devtools 里看起来一样，但打包体积不同
插件方式会在构建时预生成对应 CSS 规则，哪怕你只用了一次 text-shadow-md，整个阴影工具集的 CSS 都打进去了；arbitrary values 是按需生成，用几个就编译几个，更轻量。
- 查构建产物：插件方式在
dist/css里能看到一堆text-shadow-*的规则；arbitrary 方式只出现你实际写的那几条text-[...] - 插件支持
theme.textShadow自定义，比如加个xl: '0 2px 8px rgba(0,0,0,0.4)'，之后就能用text-shadow-xl - arbitrary values 不受 PurgeCSS 影响，但拼错一个字符（比如少个右括号）会导致整条规则失效，且无提示
深色模式下文字阴影容易糊成一团，别忘了加 dark: 前缀
文字阴影本身没有自动适配逻辑，text-[0_1px_2px_rgba(0,0,0,0.3)] 在深色背景上可能完全看不见，或者对比度爆炸。得手动配暗色版本。
- 推荐写法：
dark:text-[0_1px_2px_rgba(255,255,255,0.2)]，用浅色低透明度阴影提亮文字边缘 - 插件方式不自带 dark mode 支持，得自己 extend theme 或用
dark:覆盖 - 如果用的是
text-shadow-md这类插件 class，它不会响应dark:，只能切到 arbitrary values 才可控
