生活分享

Sass 與 SCSS 怎麼用:變數、模組與編譯流程

Sass 可以協助整理共用樣式,但瀏覽器使用的仍是編譯後 CSS。本文以原創桌遊活動網站為例,分清 SCSS 與縮排語法、Sass 變數與 CSS 自訂屬性,再說明入口檔、@use、@forward、監看編譯和輸出驗收。附操作步驟、比較表與原創圖解,並整理 Node Sass 停止維護、舊 @import 遷移及 source map 的注意事項,避免只改到會被覆寫的產出檔。

更新日期: 閱讀時間約 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,需要直接檢查輸出。

命令列預設會產生 source map,協助把編譯後規則對回來源。正式提供哪些對照資訊應依專案決定;若需要不產生對照檔,可查 --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/.sass撰寫來源同屬 Sass 的不同語法
Sass $變數編譯時修改後需重新產出
CSS --自訂屬性瀏覽器計算時使用 var() 與適用範圍
@use載入 Sass 模組明確命名空間及來源
@forward整理模組公開入口不自動供當前檔案使用
CSS 與 source map編譯輸出與除錯網站網址及公開資訊

覺得這篇整理實用嗎?分享給需要的朋友

LINE 分享
  • 生活分享

    Wix 架站指南:編輯網站、選擇方案與網址

    第一次使用 Wix,先釐清網站要完成什麼,再選擇版型與付費方案。本文以原創修鞋工作室介紹站為例,整理 Wix Editor 的頁面編輯、手機檢查、儲存預覽與發布流程,並說明自訂網域、續費、台灣付款工具及平台搬遷限制。附操作步驟、比較表和自繪圖解,協助把網站內容、功能需求與長期管理成本一起考慮,避免只看首頁完成就急著升級。

  • 生活分享

    線框圖與原型怎麼用:先驗證流程再修視覺

    線框圖、視覺稿與互動原型各有用途,重點是目前需要驗證哪一個問題。本文用原創到府植栽照護預約情境,說明如何挑選保真度、補齊流程與例外狀態,準備不暗示答案的操作任務,再將測試觀察轉成修改紀錄。附操作步驟、比較表及原創圖解,協助設計初學者與小型團隊,在投入正式開發前先看懂使用上的困難。

  • 生活分享

    www、子網域與子目錄:網站網址結構怎麼決定

    網站要不要加 www,部落格該放 blog.example.com 還是 example.com/blog/,需要從平台支援與維護方式一起判斷。本文先拆解網址中的主機名稱和路徑,再比較子網域與子目錄的內容分工、DNS 設定、HTTPS 憑證及網址一致性。附上原創決策表與上線檢查步驟,協助台灣小型網站建立容易使用、管理和交接的網址結構。

  • 生活分享

    網站維護要做什麼:備份、更新與故障回報的日常安排

    網站維護不只是更新外掛,也包含確認內容、帳號、備份、寄信與到期服務。本文以小型 WordPress 內容網站為例,把維護工作拆成日常觀察、更新前後檢查、備份還原及故障回報,提供可以分配給站主、編輯與維護者的工作表。你可以依網站更新頻率安排合適節奏,知道什麼情況要立即處理,並保留足以讓下一位協作者接手的紀錄。

資料來源

本文依據上方所列參考來源與標示之核對日期整理;票價、時刻、功能規格或服務條款可能變動,出發、預訂或購買前請至相關官方網站確認最新資訊。

生活分享