Tailwind CSS v3.0 正式引入斜杠语法（如bg-black/50），仅适用于color/background-color/border-color等颜色属性，不支持shadow、gradient方向类等非颜色场景，且v3.0–v3.2不支持渐变色标透明度，需十六进制alpha或升级至v3.3+。
Tailwind CSS v3.0 没有去掉斜杠语法——恰恰相反，它正式引入并推广了bg-black/50、text-blue-600/75 这类写法。所谓“v3.0 去掉斜杠语法”的说法是误传，常见于混淆了旧版自定义插件、PostCSS 插件或早期 alpha 版本的行为。
真正需要厘清的是：斜杠语法的适用范围有限，且与 opacity 工具类有本质区别。用错地方，就会出现“写了却没效果”“颜色没变透明”“渐变还是实色”等问题。
斜杠语法只作用于 color / background-color / border-color 等单值颜色属性
bg-blue-500/30 会被编译为 background-color: rgb(59 130 246 / 0.3)，这是 CSS 标准的「函数式颜色语法」（color function），仅适用于明确接收颜色值的 CSS 属性。
- ✅ 有效场景：
bg-[#ff0000]/20text-emerald-400/80border-red-300/40
- ❌ 无效场景：
-
shadow-lg/50（shadow 不是颜色属性，不支持斜杠） -
gradient-to-r/50（渐变方向类本身不含颜色，不能加斜杠） -
from-blue-500/30 to-white/20（Tailwind v3.3+ 才支持在每个色标上单独加斜杠；v3.0–v3.2 不支持）
-
注意：from-blue-500/30 在 v3.0 中会直接被忽略，不会生成对应样式——Tailwind 扫描器不认识这种组合，也不会报错，只是静默跳过。
立即学习“前端免费学习笔记（深入）”；
opacity-xx 和 bg-xxx/yy 的行为差异必须分清
这两个方案都“让东西变透明”，但作用机制和影响范围完全不同：
-
opacity-30→ 设置整个元素的opacity: 0.3，子元素（文字、图标、边框、阴影）全部继承该透明度 -
bg-black/30→ 仅设置背景色的 alpha 通道，文字、边框、子元素完全不受影响
常见错误现象：
- 给卡片加了
opacity-20，结果标题也看不清了 → 应改用bg-white/20+ 默认文字色 - 想让边框半透，却写了
border-gray-300 opacity-50→ 边框变淡了，但整个卡片也变淡了 → 正确写法是border-gray-300 border-opacity-50或border-gray-300/50
渐变背景的透明度必须逐个色标设置
Tailwind 对 bg-gradient-to-r from-blue-500 to-purple-500 这类渐变，不会自动把斜杠语法透传到每个色标。即使你写成 bg-gradient-to-r from-blue-500/30 to-purple-500/30，v3.0–v3.2 仍不识别。
- ✅ v3.3+ 支持（需确认已升级）：
bg-gradient-to-r from-blue-500/30 to-purple-500/0
- ⚠️ v3.0–v3.2 必须退回到十六进制带 alpha 的写法：
bg-gradient-to-r from-[#3b82f64d] to-[#8b5cf600]
（其中4d≈ 30% 透明度，00= 完全透明）
这个细节极容易被忽略：开发者看到文档里写了“支持斜杠语法”，就默认所有颜色类都可用，结果在渐变上反复试错，最后归咎于“Tailwind bug”。其实只是版本能力边界没对齐。
自定义透明度值必须改配置，不能靠拼写
Tailwind 预设的 bg-xxx/xx 只支持整数百分比（/0 到 /100），且仅映射到预设的 theme.opacity 值。如果你需要 /17 或 /83：
- 不能写
bg-black/17（v3.x 不生成该类） - 也不能靠插件“动态补全”
- 必须修改
tailwind.config.js：module.exports = { theme: { extend: { opacity: { '17': '0.17', '83': '0.83', } } } }
改完要重启 dev server，否则新类名不会出现在生成的 CSS 中。这一点和 @layer 或 @apply 的即时生效完全不同。
斜杠语法不是万能开关，它是对 CSS color 函数的封装，只在颜色上下文里起效。真正容易踩坑的，从来不是“怎么写”，而是“在哪写、不该在哪写”。
