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

如何在Gatsby项目中引入CSS样式_利用plugins插件系统加载样式

千枫大大_8214

千枫大大_8214

发布时间:2026-06-14 14:39:19

|

224人浏览过

|

来源于php中文网

原创

无效,因gatsby-browser.js不参与SSR样式提取;必须同时在gatsby-browser.js和gatsby-ssr.js中导入全局CSS,确保服务端渲染HTML的<head>含样式,避免首屏闪动或无样式。

如何在gatsby项目中引入css样式_利用plugins插件系统加载样式

直接在 gatsby-browser.js 里 import "./src/styles/global.css" 是无效的——它只在浏览器端生效,服务端渲染(SSR)时样式丢失,首屏会闪动或无样式。Gatsby 的构建流程压根不从这个文件提取 CSS。

为什么必须同时写 gatsby-browser.js 和 gatsby-ssr.js

Gatsby 在构建阶段靠 gatsby-ssr.js 注入 CSS 到 HTML 的 <head> 中,确保 SSR 输出带样式;gatsby-browser.js 负责客户端水合后的 JS 行为(比如路由监听),不参与样式注入。两个文件必须都写同一行导入,否则 CSR 和 SSR 样式不一致。

  • 漏掉 gatsby-ssr.js 是上线后首屏样式丢失的最常见原因
  • 哪怕开发时看着正常,gatsby build && gatsby serve 一跑就暴露问题
  • 检查构建产物(public/index.html)的 <head> 里有没有内联 CSS 或 <link>,是最快验证方式

用 gatsby-plugin-sass 或 gatsby-plugin-postcss 时怎么配全局样式

这类插件接管了 CSS 处理链,但它们本身不自动注入全局样式——你仍需手动在 gatsby-browser.js 和 gatsby-ssr.js 中导入,只是路径可以是 .scss 或 .css 文件。

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

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

下载
  • 安装后必须在 gatsby-config.js 中启用插件:`gatsby-plugin-sass`
  • 导入语句保持一致:import "./src/styles/global.scss"(注意扩展名)
  • 如果用了 @import 嵌套 Sass 文件,确保所有被引用的文件都在 Webpack 的 resolve 范围内,别被 exclude 规则屏蔽
  • 不要在组件里重复 import 同一个全局文件,否则 HMR 下容易样式覆盖或冲突

引入第三方 CSS(如 Bootstrap、Tailwind)的注意事项

第三方 CSS 本质也是普通 CSS 文件,同样受 Gatsby 的 SSR/CSR 分离机制约束。不能只靠组件内 import "bootstrap/dist/css/bootstrap.min.css" 就完事。

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

  • 推荐统一收口到 gatsby-browser.js + gatsby-ssr.js 导入,避免分散管理
  • Tailwind 用户:必须配合 gatsby-plugin-postcss,且 global.css 中要写 @tailwind base 等指令,不能只靠插件启用就自动生效
  • CDN 引入(如 <link rel="stylesheet">)绕过构建流程,但失去 PurgeCSS、PostCSS 等优化能力,也不支持主题变量注入
  • 若用 styled-components 或 emotion,它们自带 SSR 支持,但全局重置类(如 * { margin: 0 })仍建议走 CSS 文件 + 双入口导入,更可控

真正容易被忽略的不是“怎么写”,而是“在哪写”——gatsby-ssr.js 这个文件连很多老项目里都不存在,得手动创建。只要它缺位,所有 CSS 导入在 SSR 阶段就等于没发生。

热门AI工具

更多
豆包大模型

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

DeepSeek

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

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

PixTV
PixTV Hot

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

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

WorkBuddy

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

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

相关专题

更多
css
css

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

4256

2023.06.15

css居中
css居中

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

937

2023.07.27

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

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

1798

2023.07.28

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

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

3366

2023.08.01

css字体颜色
css字体颜色

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

6685

2023.08.10

什么是css
什么是css

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

5691

2023.08.10

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

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

1937

2023.08.21

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

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

2691

2023.08.22

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

80

2026.09.30

热门下载

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

精品课程

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

共14课时 | 1.5万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 5.8万人学习

CSS教程
CSS教程

共754课时 | 95.9万人学习

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

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