@import 必须顶格写在 .wxss 文件第一行,路径需带 ./ 或 ../、后缀不可省、仅支持相对路径且区分大小写;仅 app.wxss 中的 @import 全局生效,不支持嵌套导入。

@import 必须顶格写在 .wxss 文件第一行
任何空格、BOM、注释或空行都会导致 @import 静默失效——编译器直接跳过,不报错也不加载。这是最常踩的坑。
常见错误写法:@import "./common/base.wxss"; 前面有空行,或写成:/* 公共样式 */@import "./common/base.wxss";,这两者都无效。
- 必须严格顶格:第一字符就是
@ - 路径末尾分号
;不能省,漏了整行被忽略 - 路径区分大小写,
base.wxss和Base.wxss在 iOS 真机上不是同一个文件
路径只能是相对路径,且必须带 ./ 或 ../
@import 不支持 /styles/base.wxss、@/styles/base.wxss、styles/base.wxss 这类写法,全部静默失败。
路径基准是当前 .wxss 文件所在位置。比如 pages/index/index.wxss 要引入根目录下 styles/utils.wxss,就得写:@import "../../styles/utils.wxss";
-
./表示同级,../表示上一级,层级数要手动数准 - 不能用别名(如
@)、npm 包路径、网络地址 -
.wxss后缀不可省略,写成@import "./common/base";会失败
app.wxss 是全局样式的唯一可靠入口
只有写在 app.wxss 里的样式(或它 @import 进来的)才会自动作用于所有页面。你在某个页面的 index.wxss 里 @import,效果只限该页面。
推荐结构:app.wxss 顶部统一导入:@import "styles/reset.wxss";@import "styles/variables.wxss";@import "styles/utils.wxss";
- 所有公共样式集中放在
styles/目录下,与app.wxss同级 - 避免在多个页面 wxss 中重复
@import同一文件,否则样式可能叠加、权重混乱 - 组件内
@import受样式隔离限制,基本无效;全局类必须走app.wxss
@import 不支持嵌套,最多扁平一层
如果 A.wxss @import "B.wxss",而 B.wxss 里又写了 @import "C.wxss",C.wxss 的内容不会进入最终样式表——编译器只解析第一层。
更麻烦的是,嵌套超过 5 层(A→B→C→D→E→F)时,后续层级会被截断,且无任何提示。
- 不要把
@import当模块系统用,它只是文本拼接 - 第三方库(如 weui)的 wxss,必须确认构建后真实路径存在,再写进
app.wxss - 需要拆分管理时,由
app.wxss直接导入所有子文件,而非靠中间层转发
真正容易被忽略的,是路径计算和文件层级——开发者常凭感觉写 ../,但实际从当前文件出发向上跳的层数稍错一点,就彻底失效,而且没有任何反馈。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











