讲师中心 微信公众号
AI工具推荐 视频效率加速

uni-app项目如何全局引入CSS

冬萱大大_8689

冬萱大大_8689

发布时间:2026-08-14 11:46:19

|

361人浏览过

|

来源于php中文网

原创

CSS全局引入必须走main.js或App.vue的非scoped style块,否则小程序端失效;因scoped样式隔离导致@import规则无法透出到子页面,H5看似生效但小程序完全不生效。

uni-app项目如何全局引入css

CSS 全局引入必须走 main.js 或 App.vue 的非 scoped style 块,否则在小程序端基本失效。

为什么不能只在 App.vue 的 scoped style 里写 @import?

uni-app 编译器会把 scoped 样式隔离到组件内部作用域,@import 进来的 CSS 规则也受此限制——H5 看似生效,但微信/支付宝小程序里完全不透出到子页面或组件。这不是 bug,是编译策略决定的。

  • scoped style 中的 @import "@/static/css/reset.css" → 小程序端被忽略
  • 即使 import 成功,变量、动画、伪类选择器等也大概率无法跨组件复用
  • 官方推荐路径是:静态资源放 static/,全局样式文件统一走 JS 导入或非 scoped 块

最稳的两种方式:main.js 导入 vs App.vue 非 scoped style

二者都能绕过 scoped 隔离,但适用场景不同:

  • main.js 导入(推荐):import "@/static/css/variables.css"、import "@/common/uni.css" —— 所有平台 100% 生效,且支持动态加载逻辑(比如按主题切换引入不同 CSS)
  • App.vue 的非 scoped style:<style>@import "@/static/css/base.css";</style> —— 简单直接,但无法做条件判断,也不方便配合 JS 控制加载时机
  • 别混用:同一个 CSS 文件不要既在 main.js 导入,又在 App.vue 里 @import,可能触发重复解析或优先级冲突

引入外部 CDN CSS(如 iconfont、animate.css)的实操要点

CDN 地址不能用 @import 写在 style 标签里(uni-app 不支持解析远程 URL),必须用 JS 动态插入 link 标签。

CSS婚礼策划服务机构宣传网站模板
CSS婚礼策划服务机构宣传网站模板

CSS婚礼策划服务机构宣传网站模板是一款适合提供婚礼策划和婚庆服务机构宣传网站模板下载。提示:本模板调用到谷歌字体库,可能会出现页面打开比较缓慢。

下载

立即学习“前端免费学习笔记(深入)”;

  • 在 main.js 或 App.vue 的 onLaunch 钩子中执行:
  • const link = document.createElement("link"); link.rel = "stylesheet"; link.href = "https://at.alicdn.com/t/c/font_xxx.css"; document.head.appendChild(link);
  • 注意加 onload 回调判断加载状态,避免样式未就绪就渲染依赖它的组件
  • 微信小程序基础库低于 2.27.0 时,document.head 可能为 null,需加空值判断

常见踩坑:uni.css、iconfont.ttf、reset.css 的顺序和位置

字体文件(如 uni.ttf)必须和对应 CSS 在同一目录,且 CSS 中的 src: url(...) 路径要相对 static 根目录写;顺序错会导致图标显示为方块。

  • 正确结构:static/fonts/uni.ttf + static/css/uni.css,CSS 中写 src: url("../fonts/uni.ttf")
  • 所有全局 CSS(包括 reset、uni.css、自定义变量)应在 main.js 中按依赖顺序导入:reset → 变量 → 组件库 → 业务基础样式
  • 不要把 uni.css 放进 components/ 或 pages/ 目录下再 import —— 路径别名 @/ 指向项目根,错放会导致路径解析失败

真正容易被忽略的是:小程序端不支持 @import 嵌套超过 3 层,也不支持 @import 后接媒体查询。如果用了多层 import 链,建议全部 flatten 到一个入口 CSS 文件里再引入。

热门AI工具

更多
VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

相关专题

更多
css
css

css是层叠样式表,用来表现HTML或XML等文件样式的计算机语言,不仅可以静态地修饰网页,还可以配合各种脚本语言动态地对网页各元素进行格式化。php中文网还为大家带来html的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

4396

2023.06.15

css居中
css居中

css居中:1、通过“margin: 0 auto; text-align: center”实现水平居中;2、通过“display:flex”实现水平居中;3、通过“display:table-cell”和“margin-left”实现居中。本专题为大家提供css居中的相关的文章、下载、课程内容,供大家免费下载体验。

977

2023.07.27

css如何插入图片
css如何插入图片

cssCSS是层叠样式表(Cascading Style Sheets)的缩写。它是一种用于描述网页或应用程序外观和样式的标记语言。CSS可以控制网页的字体、颜色、布局、大小、背景、边框等方面,使得网页的外观更加美观和易于阅读。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1838

2023.07.28

css超出显示...
css超出显示...

在CSS中,当文本内容超出容器的宽度或高度时,可以使用省略号来表示被隐藏的文本内容。本专题为大家提供css超出显示...的相关文章,相关教程,供大家免费体验。

3446

2023.08.01

css字体颜色
css字体颜色

CSS中,字体颜色可以通过属性color来设置,用于控制文本的前景色,字体颜色在网页设计中起到很重要的作用,具有以下表现作用:1、提升可读性;2、强调重点信息;3、营造氛围和美感;4、用于呈现品牌标识或与品牌形象相符的风格。

6885

2023.08.10

什么是css
什么是css

CSS是层叠样式表(Cascading Style Sheets)的缩写,是一种用于描述网页(或其他基于 XML 的文档)样式与布局的标记语言,CSS的作用和意义如下:1、分离样式和内容;2、页面加载速度优化;3、实现响应式设计;4、确保整个网站的风格和样式保持统一。

5851

2023.08.10

css三角形怎么写
css三角形怎么写

CSS可以通过多种方式实现三角形形状,本专题为大家提供css三角形怎么写的相关教程,大家可以免费体验。

1997

2023.08.21

css设置文字颜色
css设置文字颜色

CSS(层叠样式表)可以用于设置文字颜色,这样做有以下好处和优势:1、增加网页的可视化效果;2、突出显示某些重要的信息或关键字;3、增强品牌识别度;4、提高网页的可访问性;5、引起不同的情感共鸣。

2791

2023.08.22

FrankenPHP集成Laravel详细教程
FrankenPHP集成Laravel详细教程

本专题提供FrankenPHP集成Laravel的详细配置指南,全面解析运行原理、开发环境搭建、Caddyfile配置、Octane工作模式、数据库连接、队列任务、定时任务和生产环境优化,解决部署过程中常见的报错与兼容性问题。

0

2026.10.08

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 1.5万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 5.9万人学习

CSS教程
CSS教程

共754课时 | 96.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn