Figma Design 教材 / Class LLL

別名參照與語義命名：這個顏色從哪裡來？

相同色碼不代表同一引用，角色名稱也不是色碼

改一個顏色卻波及不該改的地方，或只有一處沒更新？沿使用位置、語義別名參照與原始值追蹤來源，再決定修改哪一層。

撰寫與維護：Class LLL · Lab Light Label｜預估閱讀 11 分鐘

開啟互動教材查看參考來源

閱讀目標

從使用位置追到真正原始值
比較改原始色與改語義引用的影響
分清同色副本與別名參照
將命名策略視為設計決定而非官方保留字

適用條件與學習範圍

按鈕、邊框與副本現在都一樣色，為什麼修改來源後只有部分跟著變？

先分辨色彩、數值等型別與綁定；可以隨時補讀型別頁。

能指出每個使用位置的引用鏈，按想影響的範圍選擇改原始值或語義別名參照。

固定兩個色彩原值、兩個語義參照與三個使用位置，沒有循環或失效引用。別名參照同型條件有官方來源；命名分層是本站策略，不模擬完整設計代碼圖、模式或資源庫解析。

原理與判斷

直接保存色碼，是在這裡放一份值；別名參照則是引用另一個同型變數。兩處現在同色，可能只是巧合，也可能確實共用來源，不能由畫面顏色判定連動。先從使用位置逆著查引用，再決定在哪裡改。改原始值會影響仍引用它的分支；改某個語義變數的來源，只改那個角色的分支。這是本盤固定引用圖的因果，不是對任意真實檔案、模式或跨檔更新的保證。

原始值與語義角色是兩個問題

原始A、原始B各保存一個色彩色碼；動作、border說的是使用角色。本盤用這些名字協助討論責任，並不是Figma規定所有專案都必須這樣命名。「這個按鈕應使用什麼角色」與「角色目前採哪個色碼」可以分開決定。角色未必要叫primary，色碼也不必被命名成固定品牌藍；命名應讓自己的團隊知道用途與限制。不要把語義名稱直接當成對比合格或品牌審批證據。

同色副本與引用會在換值後分開

開始時動作與border都引用原始A，所以按鈕與邊框同色；直接色碼副本恰好也保存相同#72CFD2。按「改原始A」，前兩者跟著變成#A7A0EB，副本仍#72CFD2。可觀察的差別是資料引用，不是顏色名稱。若真實文件有一處沒更新，先檢查它究竟引用變數，還是保存一個看起來相同的固定值，再查模式、局部設定及資源庫更新。

改原始值與改語義別名參照會影響不同分支

讓動作改指原始B：按鈕改用B的#DDA968，border仍指A。此時再改A，只會影響仍走A的邊框；改B才會影響按鈕。原始值不是只能改一次的底色，語義別名參照也不是單純註解。先列出依賴，再按預期影響範圍修改；不為了修單一按鈕直接改所有角色共用的原始值。引用圖較大或跨檔時，還要做實際影響檢查。

別名參照的型別與命名不能互相取代

官方規則是變數可以引用同型變數：色彩引用色彩，數值引用數值。把色彩命名為間距不會讓它變數值，將數值命名為brand也不會讓它可當色彩使用。本盤的跨型別按鈕只顯示本站拒絕理由，保留最後有效參照，不冒充原生Figma錯誤介面。循環或缺失引用不在固定圖內；來源未確認的處理不補猜，也不從這個有限模型推斷工具會自動修復。

追蹤時記角色、引用與值，不能只記色碼

用「追蹤按鈕」看按鈕→動作→原始A／B；「追蹤邊框」看border→A；「追蹤副本」會看到沒有別名參照。更改角色名稱只改本盤的可讀標籤，不會改其參照或色碼。一段可靠的交接可寫成：按鈕引用哪個語義變數、該變數再引用哪個原值、現在解析為什麼。這比只截一張相同顏色的畫面更能支持後續修改。命名策略屬本站教學推導，不是一套官方唯一字典。

解除引用與跨檔更新另有責任

官方管理介面可在值欄建立別名參照，也可用解除連結別名參照解除。解除後應重新核對引用與值；不能仍期待它像原來的分支更新。本盤副本是起始就存在的獨立樣本，不假裝按過原生解除連結。 Local同檔引用與published 資源庫消費端更新不同；多模式還要核對解析情境。本頁先把追溯方法練清楚，完整模式、設計代碼與資源庫流程由相應問題承接，不以同名或同色取代真實來源。

步驟與觀察

先記錄使用位置的當前綁定
在可編輯的Design文件選自己的圖形，從填色等已綁定屬性辨認變數來源。記錄名稱、集合、型別及當前值，不只複製色碼。需要綁定入口時補讀型別與綁定頁。操作名稱對照（中文為本站教學譯名）：左側變數 > 變數值 > Create 別名參照（介面原文：左側 Variables > 變數值 > Create alias）資源庫 picker > 同型變數（介面原文：Libraries picker > 同型變數）變數值 > 解除連結別名參照（介面原文：變數值 > Detach alias）
準備同型原值與角色變數
從左側變數管理建立或選取色彩變數。以自己的命名策略區分保存實值與表達用途的角色；這是設計整理決定，不是把名稱改成semantic就自動建立引用。
由值欄建立明確別名參照
右鍵變數值選Create 別名參照，在資源庫 picker挑同型的既有變數。核對真正來源集合與可用資源庫；不要只因同名就選第一個結果。官方限制是同型，不把數值冒充色彩。
一次只改一層，比較影響範圍
先改原始值，觀察哪些使用位置仍引用它；復原後再改某個角色的別名參照來源，比較其他角色是否不受影響。真實檔案若有模式或跨檔資源庫，另外檢查其有效值與更新狀態。
用一個固定值副本做反例
保留一份原創固定色碼樣本，確認來源改色時它不因外觀曾相同就自動更新。需要解除連結別名參照時使用具名操作後再核對資料，不把本站的直接色碼樣本當原生解除實測。
交接引用鏈與停止邊界
把使用位置→語義角色→原始值寫清楚，連同集合／模式／資源庫條件一起核對。追不到原值時先查實際引用，不宣稱循環或缺失都會被工具自動修復；本盤重設只回原創圖的初值。

常見問題

只修一顆按鈕，其他地方也全部改色

先追同一原值被哪些語義角色引用；若只想改一個角色，調該角色參照而非直接改全共用原值。

一處同色卻完全沒跟著改

查是否固定色碼或另一來源，再查模式／局部覆寫／跨檔更新；外觀相同不是別名參照證據。

色彩名字叫間距，卻不能接到尺寸

名字不轉換型別；使用同型別名參照及相容目標。

改名為動作後以為角色已自動套用

命名與綁定是不同動作；核對實際引用，不把自訂名稱當官方保留字或自動規則。

追溯時只留下色碼，失去來源

記使用位置、語義變數、原始值與集合／模式；不要只截色票或把多個同名變數混為一個。

解除別名參照後仍期待來源更新

解除後重新核對引用責任；固定值不因原來同色就保留連動，跨檔來源也須依資源庫流程檢查。

適用範圍與證據

原教材查核日期：2026-10-22 適用範圍：Design local變數與別名參照；建立／編輯需可編輯。模式數與published 資源庫使用／發布另有方案及存取條件，不因local教學推全部資源庫免費可用。來源狀態：同型alias、Create alias與Detach入口採2026-10-22 Scrapling V01已讀正文；綁定採當日V02；六型總覽S16沿21日cache。循環／失效參照全部工具處理未核，不寫原生保證；primitive／semantic為本站教學策略。示意限制：原創兩色彩原值、兩語義別名參照、三使用位置固定無循環圖；顏色、耦合器、追蹤與讀數同源。不解析真Figma 設計代碼圖／模式／跨檔資源庫，跨型別拒絕是本站觀察回饋。原生軟體實測：僅本站公開瀏覽器驗證，未原生Figma建立、修改、解除連結或發布實測。學習成效驗證：未真人試用，沒有學習成效或遷移實測。

參考來源

來源依原教材逐頁維護；本次建立閱讀網址不代表重新完成原生軟體或真人學習測試。如遇版本差異或內容錯誤，歡迎來信提出具體段落與版本。