Tailwind CSS 不支持 border-gradient，需用外层渐变背景 + 内层实色背景配合 p-1 实现；必须双层 DOM、同步设置 rounded-lg 和 overflow-hidden，响应式需用 sm:p-1 md:p-2 等前缀。
为什么 border-gradient 不存在，但你总想用它
Tailwind CSS 官方不提供渐变边框的原子类，border 相关工具仅支持纯色。直接写 border-gradient-to-r from-blue-400 to-purple-500 会完全失效——这不是你配置错了，是它压根没这个功能。
真正可行的路径只有一条：用一层带渐变背景的「外容器」包裹内容，再通过 p-1（或任意小内边距）制造视觉上的“边框厚度”，让渐变从父容器透出，子元素用 bg-white（或其它背景色）盖住中间区域。
- 必须用两层 DOM：外层负责渐变，内层负责内容和遮罩背景
-
p-1的值决定“边框”粗细，p-0.5在支持的版本中更精细，但部分旧版 Tailwind 不识别 - 外层不能设
border，否则会叠在渐变上，破坏效果
怎么用 bg-gradient-to-r + p-1 搭出可用的渐变边框
核心结构固定：<div class="bg-gradient-to-r from-cyan-400 to-blue-500 p-1"><div class="bg-white">内容</div></div>。外层渐变，内层实色背景，p-1 就是露出的渐变“边”。
常见错误是把 bg-gradient 加在按钮或卡片自身上，结果整个背景都渐变了，不是边框。
立即学习“前端免费学习笔记（深入）”；
- 渐变方向可换：
bg-gradient-to-b（下）、bg-gradient-to-br（右下）等，按需调整 - 颜色要选对比强的组合，否则“边框感”弱；比如
from-gray-200 to-gray-400在白底上几乎看不见 - 如果内层需要透明（如玻璃态 UI），改用
backdrop-blur+ 半透背景，但得加bg-black/10类控制透出程度
遇到 rounded-lg 圆角不生效或锯齿怎么办
渐变边框圆角失效，通常是因为内层元素没同步设置圆角，导致外层渐变被内层直角“切掉”。rounded-lg 必须同时加在外层和内层，且内层的 rounded-lg 还要配合 overflow-hidden 防止渐变溢出。
- 正确写法：
<div class="bg-gradient-to-r from-emerald-400 to-teal-500 p-1 rounded-lg"><div class="bg-white rounded-lg overflow-hidden">内容</div></div> - 如果用了
shadow，注意阴影层级：加在外层会包住整个渐变边，加在内层则只罩内容，视觉更干净 - 在 Safari 上偶现圆角锯齿，可加
will-change: transform或translateZ(0)强制 GPU 渲染（仅必要时）
响应式渐变边框：怎么让 p-1 在小屏变细、大屏加粗
p-1 是固定值，无法自动响应。想实现“小屏 1px 边、大屏 2px 边”，得用响应式前缀：sm:p-1 md:p-2。但要注意，渐变本身不会随尺寸缩放，所以边越宽，颜色过渡越平缓，可能显得发灰。
- 推荐组合：
sm:p-0.5 md:p-1 lg:p-1.5（需 Tailwind v3.2+ 支持p-0.5） - 移动端慎用太细的渐变边（如
p-0.5），OLED 屏易出现渲染断点，肉眼可见“虚线感” - 若需精确控制像素宽度，改用自定义 CSS 变量 +
border-image，但会脱离 Tailwind 原子体系，维护成本上升
最易被忽略的是：渐变边框在深色模式下颜色可能反差不足，别只在 light 主题下测。还有，bg-gradient 的起止色在高缩放比例（如 125%）下可能出现色带，不是 bug，是渐变插值精度限制。
