用途:面向 Tailwind CSS v4 的移动优先响应式设计,提供断点策略、流体排版与间距、触控目标、容器查询、安全区域、响应式布局与媒体、导航以及移动端性能方面的实现指导、调试、架构选择与生产加固。
核心工作流:先用无前缀工具类建立移动端基线,再用 sm:、md:、lg:、xl:、2xl: 逐步增强;断点依据内容需求而非设备名称选择,仅在设计系统需要时覆盖 Tailwind v4 主题断点;用 clamp() 配合 rem 与 vw 实现流体排版和间距,兼顾可访问性;交互元素按 44px 推荐触控目标、留足间距、标签清晰并采用移动导航模式;可复用组件用容器查询响应自身宽度而非视口宽度;用 aspect-ratio 预留媒体尺寸,用 safe-area 工具类适配刘海屏与固定移动 UI。
注意事项:无前缀类在所有尺寸生效,带断点前缀的类在该断点及以上生效;桌面优先的类顺序不会让设计变成桌面优先,反而易掩盖意图并增加缺陷;仅悬停交互在触屏失效,需配合 focus、active 或显式控件;未预留宽高比的视频和图片会造成累积布局偏移;固定底部导航须考虑安全区域内边距并给内容加内边距避免遮挡。
参考文件:references/mobile-first-complete-guide.md 为完整原始指南,涵盖理念、断点、流体字号与间距、触控目标、容器查询、布局、响应式图片与文字、导航、安全区域、移动性能、测试与响应式视频模式。
响应建议:除非存在明确兼容性或性能理由,保留用户现有框架、库与工具链选择;仅针对当前任务给出可复制代码,否则指向相关参考章节;说明权衡、失败模式与生产验证步骤;优先可访问、可维护、可度量的方案。