用途：这是一份 Tailwind CSS v4 的语法与迁移参考资料，适合在编写 v4 样式或把现有项目从 v3 升级到 v4 时查阅。
主要能力：
- 导入与设置：用 @import "tailwindcss"; 取代 v3 的 @tailwind 指令；用 @utility 定义自定义工具类，取代 @layer utilities；如需旧版 JS 配置，可用 @config "../../tailwind.config.js"; 加载。
- 主题变量：v4 将主题值暴露为 CSS 变量，建议直接用 var(--color-red-500)、var(--font-sans) 等，而非 theme()。
- v3→v4 变更速查：包含重命名工具类（如 shadow-sm→shadow-xs、shadow→shadow-sm、drop-shadow、blur、backdrop-blur、rounded 系列的尺度位移，outline-none→outline-hidden，ring 默认由 3px 改为 1px）；废弃工具类改用透明度修饰符（bg-opacity-50 → bg-black/50；flex-shrink-→shrink-、flex-grow-→grow-、overflow-ellipsis→text-ellipsis）。
- 默认值变化：边框颜色由 gray-200 改为 currentColor，ring 宽度 3px→1px，ring 颜色 blue-500→currentColor，按钮 cursor 由 pointer 改为 default。
- 变体叠加顺序由右到左改为左到右（first:*:pt-0 → *:first:pt-0）；任意值中变量语法由方括号改为圆括号（bg-[--brand-color] → bg-(--brand-color)）；前缀写在最前（tw:flex tw:bg-red-500）。
使用方式：项目迁移可运行 npx @tailwindcss/upgrade，需 Node.js 20+，建议在新分支执行并检查改动。完整迁移细节（PostCSS/Vite/CLI 配置、自定义工具类、框架特定问题）见 references/upgrade-guide.md。
适用场景：编写或审查 Tailwind v4 样式、升级既有项目、查找新旧类名对应关系。
限制：资料聚焦语法与迁移参考，未提供收费、价格、平台支持范围或效果保证等信息。