应直接使用 styled-media-query 而非手写 media 模板函数,因其可避免单位混淆、逻辑反直觉、断点配置分散、不支持 between 复合条件等问题,并提供语义化封装如 lessthan("medium") 等价于 @media (max-width: 767.98px)。

直接用 styled-media-query,别自己手写 media 模板函数 —— 除非你明确需要控制断点单位、逻辑或与现有系统耦合。
为什么手写 media 模板函数容易出错
自己封装 media 对象(比如用 Object.keys(sizes).reduce(...))看似灵活,但实际踩坑密集:
- 单位混淆:
sizes里存的是px,但模板里常误写成em或漏除以16,导致断点错位 - 逻辑反直觉:多数人写
media.tablet本意是“在平板上生效”,但若按max-width实现,它其实在手机+平板都生效,需额外加min-width才能精准限定区间 - 无法复用断点配置:项目中其他地方(如 JS 判断、工具函数)若也依赖断点值,手写模板会让这些值散落各处,改一个要搜三处
- 不支持
between这类复合条件,硬写会嵌套多层@media,生成冗余 CSS
用 styled-media-query 替代手写模板的实操要点
它不是“另一个库”,而是对原生媒体查询的语义化封装,核心就三点:
-
lessThan("medium")→ 等价于@media (max-width: 767.98px)(注意是 小于,非 -
greaterThan("large")→ 等价于@media (min-width: 1170.02px)(避免边界重叠) -
between("medium", "large")→ 自动组合min-width和max-width,无需手动算差值
默认断点已覆盖主流设备:small: "450px"、medium: "768px"、large: "1170px"、huge: "1440px"。真要改,只在一个地方导出配置即可:
import media from 'styled-media-query';
// 覆盖默认值(必须在所有组件 import 前执行一次)
media.setConfig({
breakpoints: {
mobile: '480px',
tablet: '768px',
desktop: '1200px',
},
});
当真要手写 media 函数时,必须检查的三件事
比如团队规范强制用 JS 控制断点,或需对接设计系统 token,那至少确保:
- 断点值统一从单个
breakpoints.ts导入,禁止字面量硬编码 - 每个方法显式声明单位,例如
maxWidthPx(breakpoint)或minWidthEm(breakpoint),避免混用 - 导出的
media对象必须包含between方法,否则响应式区间逻辑会残缺 —— 它不能靠两个lessThan+greaterThan拼出来,因为边界值处理不同
最常被忽略的是:断点数值本身是否和设计稿一致。很多项目用 768px 当平板上限,但设计给的标注是 767px,差这 1px 就会导致某台 iPad 上样式突变 —— 这种问题不会报错,只能靠真机连测发现。











