生活分享

Sass 与 SCSS 怎么用:变量、模块与编译流程

Sass 可以帮助整理共用样式,但浏览器使用的仍是编译后的 CSS。本文以原创桌游活动网站为例,分清 SCSS 与缩进语法、Sass 变量与 CSS 自定义属性,再说明入口文件、@use、@forward、监听编译和输出验收。附操作步骤、比较表与原创图解,并整理 Node Sass 停止维护、旧 @import 迁移及源码映射的注意事项,避免只修改会被覆盖的输出文件。

阅读时间约 7 分钟

LINE 分享
Mokaair 原创源文件夹、编译服务器与浏览器画面插图,代表 Sass 模块转换为 CSS 后的验收流程。
图片:Mokaair (© Mokaair)
目录
  1. 1. Sass 是工具,SCSS 是其中一种语法
  2. 2. 确认现有构建方式,再加入编译器
  3. 3. 分清编译期变量与浏览器中的变量
  4. 4. 以 @use 管理源文件,以 @forward 整理导出接口
  5. 5. 监听方便修改,输出仍需验收
  6. 6. 处理旧项目时,不只消除警告文字

网站积累了活动卡片、场地信息和报名按钮后,共用颜色与间距可能散落在许多文件中。Sass 可以把这些配置与可重用规则整理成模块,但多了一个编译步骤,也就需要知道源文件在哪里、谁负责生成 CSS。

以下桌游活动网站的文件名与样式示例均为原创,根据 2026 年 9 月 14 日查阅的 Sass 官方文档整理。本文是工作流程教程,没有替读者安装软件包、改动现有项目或宣称完成实际编译测试。

Sass 是工具,SCSS 是其中一种语法

Sass 提供两种主要写法:.scss 使用大括号和分号,与普通 CSS 更接近;.sass 则以缩进和换行组织内容。它们都由 Sass 编译器转换成网站可用的 CSS,不能只把扩展名改成 .css 就当作已完成转换。

初学者如果已经掌握基本 CSS,可以先选择 SCSS,减轻同时适应新语法的负担。接手现有项目时,先查看原有惯例,不需要为了统一偏好而改写全部文件。浏览器仍按 CSS 的选择器、层叠与盒模型排列内容,Sass 不会替你修正错误的布局逻辑。

现在 CSS 本身也有自定义属性与原生嵌套写法,不能再用 CSS 完全没有变量或嵌套规则来解释 Sass 的必要性。先看是否确实需要模块、编译期运算和共用规则;只有少量样式的页面,直接维护 CSS 也可能更容易交接。

确认现有构建方式,再加入编译器

官方主要实现是 Dart Sass,可通过不同方式安装;使用 Node.js 项目时会遇到 sass 包。Node Sass 已于 2024 年宣布停止维护,旧教程中的 node-sass 不宜直接作为新项目起点。先确认框架与构建工具支持哪种集成方式。

如果项目已有 Sass 依赖包及编译命令,先沿用它的入口与输出位置,避免另行启动一个编译器覆盖同一份 CSS。新增工具时记录软件包与锁文件,让协作者能获取一致的版本;不要只依靠某台电脑全局安装的工具,却没有项目说明。

在已正确安装且 sass 命令可用的练习环境中,可以用 sass styles/game-night.scss public/game-night.css,把入口转换为指定输出。文件名是本文示例,执行前先创建源文件,并确认目标不会覆盖手写文件。网站要加载 public 中对外提供的 CSS 网址,而非直接加载 SCSS。

分清编译期变量与浏览器中的变量

Sass 变量以 $ 开头,例如 $card-gap: 18px;,再在声明中使用 gap: $card-gap;。编译后,使用它的位置会替换为相应值,浏览器不会保留这个 Sass 变量供 JavaScript 实时修改。因此修改它通常需要重新生成 CSS 才能更新网站。

CSS 自定义属性则使用 --card-gap 这类名称,并以 var(--card-gap) 取值,会保留在 CSS 中参与浏览器的计算与继承。如果希望按主题或特定容器在运行时改变值,可以考虑自定义属性;如果是生成多份样式时的固定配置,Sass 变量也能提供便利。

两者可以一起使用,但要说清楚值在哪个阶段确定。桌游活动页可把编译时的基本间距与浏览器按主题调整的颜色分开管理。不要因为两者都被叫作变量,就期待修改 Sass 源文件后,已打开的网页会在没有重新编译或更新资源时自动改变。

以 @use 管理源文件,以 @forward 整理导出接口

可以把共用配置放在 styles/_tokens.scss,再在 styles/game-night.scss 的开头写 @use 'tokens';。如果模块定义了 $card-gap,就以 tokens.$card-gap 获取,让读者看得出数值从哪里来。以下划线开头的局部文件(partial)是供其他文件加载的片段,通常不作为独立输出入口。

@use 加载的成员只在该样式表中可见,其他模块如果需要相同配置,仍要自行加载。相同模块生成的样式在同一次编译中只纳入一次;这不代表所有入口生成的 CSS 合在网站上后,永远没有重复规则,仍要查看实际输出与加载方式。

模块变多时,@forward 可以将公开的变量、函数或 mixin 整理成一个对外入口;它不会自动让转出的成员在当前文件中可直接使用,需要使用时仍要加上 @use。初期先保留清晰的命名空间,不急着用 as * 把所有名称放在一起。

监听方便修改,输出仍需验收

练习时可使用 sass --watch styles/game-night.scss public/game-night.css,在源文件变化后重新编译。这条命令负责更新文件,不等于会启动网站服务器或替浏览器刷新页面。修改共用片段后,确认监听范围包含它,且终端没有报错。

Dart Sass 的 expanded 输出更便于阅读;--style=compressed 可减少多余字符,适合需要压缩的输出流程,但不能保证样式已经优化或兼容。过深的嵌套选择器、大量重复展开的 mixin,也可能生成不易维护的 CSS,需要直接检查输出。

命令行默认会生成源码映射,帮助把编译后的规则对应回源文件。正式提供哪些映射信息应根据项目决定;如果不需要生成映射文件,可查看 --no-source-map。不要在样式、注释或内嵌源代码里放置机密数据,也不要只删除文件却留下失效的映射链接。

  1. 查看项目现有 Sass 版本、命令、入口及 CSS 加载位置。
  2. 创建小型 SCSS 入口与共用配置,以 @use 明确引用。
  3. 执行一次编译,再启动监听并确认修改能生成正确 CSS。
  4. 检查警告、选择器、实际页面及交接文件,记录待迁移项目。

处理旧项目时,不只消除警告文字

Sass 的 @import 及部分全局内置函数自 Dart Sass 1.80.0 起被标记为弃用。这与浏览器原生 CSS 的 @import 不是同一回事,也不表示所有旧 Sass 源文件在查证日都已完全无法编译。需要根据实际版本与依赖包安排迁移。

官方提供 Sass migrator 帮助转换为模块,但仍要核对源文件顺序、命名空间、配置方式与输出差异。先保留可恢复版本,在副本或独立分支中处理;如果问题来自第三方包,查看其更新状态。关闭警告显示不等于已经修正兼容性问题。

验收时除了编译成功,也要确认网站加载新 CSS、长文本与窄屏幕的显示没有变差、共用配置只影响预定组件。日常修正要回到 SCSS 源文件,避免手改生成文件后,下次编译时所有修改都消失。交接应包含源文件、依赖版本、构建命令与输出位置,让其他人能重新生成相同成果。

四张卡片说明 SCSS 源文件、模块加载、Dart Sass 编译及 CSS 页面检查,提醒日常修改要回到源文件。
修改源文件、重新编译、确认页面;三件事都完成,变更才真正落实到网站。 · 图片:Mokaair (© Mokaair)
阅读完整文字说明

四张卡片说明 SCSS 源文件、模块加载、Dart Sass 编译及 CSS 页面检查,提醒日常修改要回到源文件。

本表区分源文件、编译与浏览器运行,避免把语法整理误认为实际页面已验收。
项目发生在哪个阶段要确认什么
.scss/.sass编写源文件同属 Sass 的不同语法
Sass $变量编译时修改后需重新生成
CSS --自定义属性浏览器计算时使用 var() 与适用范围
@use加载 Sass 模块明确命名空间及来源
@forward整理模块公开入口不自动供当前文件使用
CSS 与源码映射编译输出与调试网站网址及公开信息

觉得这篇整理实用吗?分享给需要的朋友

LINE 分享
  • 生活分享

    www、子域名与子目录:如何决定网站网址结构

    网站要不要加 www,博客该放在 blog.example.com 还是 example.com/blog/,需要结合平台支持情况与维护方式判断。本文先拆解网址中的主机名和路径,再比较子域名与子目录的内容分工、DNS 设置、HTTPS 证书及网址一致性。附上原创决策表与上线检查步骤,帮助台湾小型网站建立便于使用、管理和交接的网址结构。

  • 生活分享

    找网页设计公司前:需求书、报价与交付清单

    找网页设计公司前,先把网站要服务的人、主要操作与交付内容写清楚,才能比较报价。本文以小型工作室的网站需求为例,整理页面与模板数量、内容责任、功能规格、手机与无障碍验收、账号及源文件交接,并说明上线后维护怎么约定。提供可直接改写的需求清单,帮助减少追加费用与沟通偏差,不列服务商推荐名单。

  • 生活分享

    网页设计怎么开始:需求、内容与验收的完整顺序

    第一次做网站,最容易卡住的往往不是配色,而是需求、内容和验收方式没有说清楚。本文以原创社区修缮工作室网站为例,从访谈用户、整理资料、画出原型到安排开发与交接,说明每阶段应留下的成果。附流程步骤、比较表、学习资源及原创图解,帮助自行制作或委托设计的读者,把网站是否完成转化为可以实际确认的任务。

  • 生活分享

    网站缓存与 CDN:更新未显示时该清哪一层

    网站已更新,手机却还看到旧内容,可能是不同位置保留了缓存。本文以台湾工作室修改营业时间为例,整理浏览器、WordPress/主机和 CDN 的分工,说明缓存响应、过期时间与定点清除的判断方式。附操作顺序、比较表和原创图解,帮助网站管理者查出旧版本来源,也兼顾会员与购物流程的正确性。

资料来源

本文依据上方所列参考来源与标示之核实日期整理;票价、时刻、功能规格或服务条款可能变动,出发、预订或购买前请至相关官方网站确认最新信息。

生活分享