多數人以為要在 WordPress 加一段程式碼(追蹤碼、一小段客製 CSS、一個小功能),就只能硬著頭皮打開主題的 functions.php,改壞了輕則某個功能失效,重則整個網站白屏,連後台都進不去。其實還有一條更省事的路,把「新增一段程式碼」變成跟管理外掛一樣直覺的操作。
Code Snippets 就是做這件事的外掛,把每一段程式碼都當成一筆獨立的「片段」(snippet),各自有名稱、說明、標籤,還有一個開關可以單獨啟用或停用。片段存放在資料庫裡自己的一張表,不寫進主題任何檔案,換主題或升級 WordPress 都不會被連帶清掉,這跟直接改 functions.php 有明顯落差:後者只要主題一推播更新,手動加進去的那幾行往往整批被覆蓋。
先從安裝完成後,後台介面實際長什麼樣子開始講起。
Code Snippets 是什麼?把程式碼搬出 functions.php 的圖形介面
打開主題資料夾裡的 functions.php 加一段程式碼,是很多人處理小功能的第一直覺,比如在網站的所有頁面埋一段追蹤碼,或加一個自訂的簡碼。問題是這個檔案本身很脆弱,佈景主題只要推播更新,手動加進去的那幾行大多會被整批覆蓋;而這段程式碼本身只要有一個語法錯字,輕則某個功能失效,重則整個網站直接白屏,得靠 FTP 連進主機手動改檔案才救得回來。
Code Snippets 把這個風險拆解開來。每一段程式碼在它眼裡是一則獨立的片段,有自己的名稱、說明、標籤,還有一個獨立的啟用與停用開關,跟管理一支外掛幾乎一模一樣。官方直接把這個概念講白,片段其實就是一支「迷你外掛」(mini-plugin)。片段存放在資料庫的 wp_snippets 資料表,不寫進主題任何檔案,所以換主題、升級 WordPress 都不會被連帶清掉;官方的常見問答也明白保證,不會因為換主題或升級而遺失片段,因為片段本身就跟主題脫鉤,存在資料庫裡。
這支外掛在 WordPress.org 上的有效安裝數超過 100 萬個,評分落在 4.7 分(滿分 5 分),509 則評價裡有 453 則給了滿分五星,在同類「程式碼管理」外掛裡算是安裝基數數一數二的一支。它相容 WordPress 5.5 以上的版本(官方測試到 7.1),同時要求 PHP 7.4 以上,對多數還在正常維護的網站來說,這個門檻不算高。

安裝完成後,後台側邊欄會新增的功能選單
跟安裝其他外掛的路徑一樣,在後台的外掛頁面搜尋「Code Snippets」,直接點安裝並啟用即可;沒有連網或有特殊限制的環境,也可以把外掛壓縮檔手動上傳到 wp-content/plugins/ 資料夾,再從外掛清單啟用。
啟用後,左側選單會多出一個獨立的「Snippets」主選單,底下再分成幾個子項:「全部片段」是管理清單,列出目前建立過的每一則片段與啟用狀態;「新增片段」是編輯器,寫程式碼、設定執行範圍都在這裡;「匯入」用來把別的地方匯出的片段檔案搬進來;「設定」管全域選項,像是要不要壓縮輸出的 CSS 與 JS、編輯器要用哪一種配色主題;「雲端帳號」則是瀏覽、連結 Code Snippets Cloud 的入口。

新增片段可選的四種程式碼類型
點進「新增片段」頁面,結構其實跟寫一篇文章很像:先填片段的名稱,再選這段程式碼屬於哪一種類型,把程式碼本體貼進編輯區,接著選執行範圍,最後補上說明與標籤方便日後搜尋。官方開放四種程式碼類型:PHP、HTML、CSS、JavaScript,分別對應不同的用途,PHP 拿來寫邏輯與函式,像是修改後台行為或建立自訂函式;HTML 拿來放短碼式的內容片段;CSS 負責樣式微調;JavaScript 則用來做前端互動。
這裡有一個很多人裝了外掛才發現的分界,免費版只開放 PHP 與 HTML 兩種類型,CSS 與 JavaScript 屬於付費版 Code Snippets Pro 才解鎖的類型。並不是說免費版完全寫不了樣式或腳本,常見的繞道做法是把 CSS 包在 <style> 標籤裡、把 JavaScript 包在 <script> 標籤裡,再透過 PHP 片段掛在 wp_head 或 wp_footer 這兩個掛勾上輸出,一樣能在免費版跑起來,只是少了獨立類型頁籤的語法提示與驗證。

不管選哪一種類型,每一則片段都可以填名稱、說明與標籤這三個欄位。說明用來記錄這段程式碼是做什麼用的、什麼時候加的,標籤則是分類用,方便之後在幾十則片段裡快速篩選。
片段能設定的三種執行範圍與僅執行一次的選項
片段存好之後,還要決定它在網站的哪個位置跑。Code Snippets 提供的執行範圍選項是:全站執行(前台後台都會觸發)、只在後台執行、只在前台執行;另外有一個獨立的「只執行一次」模式,片段存檔並執行過一次之後就不會再自動觸發,適合資料庫欄位調整、搬家後要跑一次的清理腳本這類一次性工作。
選哪一個要看片段的用途,追蹤碼多半只需要「只在前台執行」,調整後台介面(例如隱藏某個選單項目)就選「只在後台執行」,大部分函式改動與掛勾邏輯選「全站執行」最保險,一次性的遷移或修復腳本才用「只執行一次」。近期版本也替「只執行一次」加了一層確認流程,操作前會先跳出提示,避免誤按導致腳本又被觸發一次。一次性腳本通常沒有「重複執行也沒差」的安全網,多一層確認算是實際的保護。
用面板開關直接切換片段的啟用和停用
「全部片段」清單頁上,每一則片段旁邊都有一個開關,操作方式跟外掛清單一模一樣,點一下就能暫停或恢復某段程式碼的執行,不需要打開編輯頁,也不需要刪除任何程式碼。停用不等於刪除,程式碼還完整留在資料庫裡,只是暫時不會被觸發,這對除錯特別有用,懷疑某段片段跟另一個功能衝突時,先停用它看問題有沒有消失,確認之後再決定要修改還是刪除。
清單頁還支援多選片段,一次批次啟用、停用、匯出或移到垃圾桶,片段一多的時候省下不少逐一點擊的時間。較新的版本也替這個清單頁加了幾樣東西:卡片檢視讓你用縮圖式的版面瀏覽片段,不必只看一列列的文字清單;片段預覽視窗可以直接在清單頁看到程式碼內容,不用點進編輯器;片段鎖定則是替重要片段加一道保護,避免手滑誤刪或誤改。
片段的執行優先順序、用標籤做的分類管理
片段一多,兩件事就開始重要。第一是「優先順序」,決定同時啟用的多個片段誰先誰後執行。如果某段片段要修改的是另一段片段先建立好的資料或設定,執行順序一旦顛倒,輕則沒有效果,重則直接出錯。這個欄位在多站台環境下也一樣生效,官方就修過「多站台抓取有效片段時,排序沒有優先照優先順序欄位排」這類問題,說明它是持續在維護的核心機制,不是可有可無的細節。
第二是標籤。片段編輯頁的標籤欄位直接沿用 WordPress 內建的標籤編輯器,操作方式跟幫文章加標籤完全一樣,不用重新學一套介面。片段數量一多,靠標籤篩選比在清單頁一則一則往下滑快得多,尤其是團隊裡不只一個人在維護片段庫的情況。
片段讓網站當機時,靠安全模式重新登入後台
這是 Code Snippets 內建的救援機制,也是敢放心讓自己或團隊成員直接在後台寫程式碼的關鍵。啟用一段有語法錯誤或彼此衝突的片段,輕則某個功能失效,重則整個網站白屏、連後台都進不去。遇到這種狀況,官方文件說明,安全模式啟用期間,所有片段都會暫時「暫停」,讓你能重新進入後台,把出問題的那段片段關掉,不必碰資料庫,也不用透過 FTP 搶救。啟用方式之一是在 wp-config.php 加入一行 define( 'CODE_SNIPPETS_SAFE_MODE', true );,放在檔案裡「就這樣,別再往下編輯」那行註解之前即可,這種方式屬於永久開啟,適合已經確定網站進不去、必須從主機端搶救的情況。
另一種方式更輕量,直接在目前頁面的網址後面加上 &snippets-safe-mode=1,單次啟用安全模式,只對這一次瀏覽生效。官方也說明這只對已經以管理員身份登入的使用者有作用,一般訪客看到的前台畫面完全不受影響。為了方便隨手啟用,官方還提供一個瀏覽器書籤小工具,存進書籤列之後,點一下就能幫目前網址自動加上安全模式參數。要提醒的是,安全模式是暫時性的除錯手段,排查完問題就該關掉,不是常態設定。

片段可以匯出成 JSON 或 PHP,帶著搬到別的網站
片段可以用兩種格式匯出,用途不太一樣。匯出成 JSON 是給「另一台也裝了 Code Snippets 的網站」用的完整備份格式,連名稱、說明這些欄位都會保留,匯入後幾乎跟原本一模一樣。匯出成 PHP 則是給「沒有裝這支外掛、只想要純程式碼」的情境準備的,產生的 PHP 檔案會把原本片段的名稱與說明寫成程式碼裡的註解,方便日後回頭查這段程式碼原本是做什麼用的。
操作路徑上,單則片段可以在「全部片段」清單頁,從該片段名稱下方的連結直接匯出;要一次匯出多則,則是在清單頁多選之後,從「批次操作」選單選匯出。設定頁另外有一個「完整解除安裝」選項,勾選之後,之後從外掛頁刪除這支外掛時,會連同所有片段一起清空,官方也提醒,真的要刪除外掛之前,務必先把重要的片段匯出備份,不然資料就跟著外掛一起消失。
從其他程式碼片段外掛匯入既有片段
對原本用別支片段外掛、想換過來的讀者,這個功能省下重新打一次程式碼的工,較新版本開始支援直接匯入 Header Footer Code Manager、Insert Headers and Footers、Insert PHP Code Snippet 這幾支常見片段外掛既有的片段,也加入了拖放上傳檔案的匯入介面,操作起來比早期版本只能貼原始碼順手不少。
匯入介面會先列出偵測到的舊片段,讓你在真正匯入前看一遍清單,確認要保留哪些、要不要調整名稱或標籤再匯入。這對正在把好幾個網站陸續換成用 Code Snippets 管理程式碼的人特別實用,不用逐一開啟舊外掛把程式碼複製貼上,省下的時間跟出錯風險都值得。
多站台網路安裝時,片段可以整個網域共用
如果管理的是 WordPress Multisite(用同一套系統管理很多個子站)的環境,Code Snippets 支援兩種啟用方式。一種是在「網路控制台」整個網路啟用,效果是每個子站都會套用同一批全域片段,由網路管理者統一維護;另一種是只在主站啟用,再由各站台的管理者依需要各自個別啟用,片段各自獨立管理,互不影響。
透過網路控制台整個網路啟用之後,會開啟一個專門處理跨站台片段的管理介面,方便統一調整整個網路共用的程式碼。這個功能不是邊緣角落,近期幾個版本的更新紀錄都還持續在修正多站台情境下的權限判斷與片段查詢邏輯,代表官方把它當成核心情境在維護,而不是裝了就沒人管的舊功能。
免費版就能瀏覽、下載的雲端社群片段庫
Code Snippets 內建整合一個名叫「Code Snippets Cloud」的社群片段庫,概念類似外掛庫,不用自己從零開始寫程式碼,可以先搜尋看看有沒有其他使用者已經公開分享過類似的片段,直接下載使用。這個公開搜尋與下載功能免費版就能用,不是只有付費版才開放,對剛接觸 Code Snippets、還不熟怎麼自己寫程式碼的人是很實際的入門管道。
較新的版本替雲端搜尋加了不少改進:卡片式的瀏覽介面、精選片段的推薦、更細的篩選條件跟分頁,整體體驗比早期只有一個純文字清單的搜尋要接近「逛外掛庫」的感覺。不過要留意的是,雲端片段來自不同使用者投稿,不是官方逐一審核保證安全,下載回來的每一段程式碼,都該先讀過一遍再啟用,這個習慣不管片段從哪裡來都該養成。
只有付費版開放的條件式載入邏輯
免費版的執行範圍只能選「全站、後台、前台、只執行一次」這幾種比較粗顆粒的設定,Pro 版另外開放一個叫「條件」的功能,官方形容它是一套強大的邏輯建構器,可以設定更精細的載入條件,像是只在某些特定文章類型、特定網址、特定使用者角色的情況下才執行這段片段。設定好的條件組合還可以重複套用到不同的片段上,不用每次都重新設一次。
這是免費版做不到的地方,也是要精準投放程式碼、比如只想讓某個追蹤碼在特定活動頁面出現才用得到的進階功能。官方也持續在打磨這個功能,像是修過條件搭配 CSS 或 JS 片段時載入時機重複、以及某些條件因為在迴圈跑之前就載入而失效這類問題,可以看出這不是一次做完就丟著不管的功能,而是持續維護中的付費賣點。

AI 協助生成與解說程式碼的付費功能
Pro 版另一個近年主打的付費功能,是編輯片段時可以請 AI 幫忙解讀程式碼。點下「解說」按鈕,AI 會針對目前這段程式碼產生一段白話說明,不太懂 PHP 的人也能大概看懂這段在做什麼,這對接手別人留下的舊片段特別有用,不必自己從頭讀懂每一行邏輯。
另一個子功能是「生成」,依照打的描述產生一段新的片段草稿。不管是解說出來的說明,還是生成出來的程式碼,都還是需要自己動手檢查驗證,不是全自動、不用看就能直接上線的東西。
跨站同步的雲端保管庫、付費限定的方案組合
延續前面提到「免費版就能搜尋公開雲端片段庫」,Pro 版另外解鎖的是「私有雲端」的用法,把自己寫的片段同步存進一個叫 Codevault 的私有雲端保管庫,跨多個網站共用同一批自訂片段。這對同時經營好幾個網站的人省下不少工,不用每個新網站都重新寫一次同樣的自訂函式,寫好一次、跨站同步就能直接用。

Pro 版的雲端片段也會顯示更細的狀態標籤,包括公開、私人、未驗證、AI 驗證、官方驗證、不通過、審核中、社群驗證幾種,方便判斷一段雲端片段的可信程度落在哪一級。另外還有「組合」功能,可以把多則相關的片段打包成一組,一次分享或下載整組,不用一則一則個別處理。
Elementor 和 Gutenberg 區塊的直接嵌入
Pro 版還整合了 Elementor 小工具與 Gutenberg 區塊,片段可以直接拖進頁面編輯器裡嵌入,不用再回到片段清單頁另外設定執行範圍跟顯示位置。
對已經習慣用頁面編輯器組版面的人,這個做法比切換到後台選單設定執行範圍更直覺,片段像是變成編輯器裡的一個元件,拖放的同時就決定了它出現的位置,對只想在某個頁面局部嵌入一段程式碼、而不是整站套用的情境特別方便。
免費版功能的涵蓋範圍,以及升級 Pro 的判斷依據
把前面逐項走過的功能攤開來看,判斷免費版夠不夠用其實有一條清楚的界線。如果只需要寫 PHP 或 HTML 類型的片段、不需要精細到「只在某個文章類型或某個角色才執行」的條件式邏輯、經營的也只有一個網站,免費版就已經涵蓋大部分日常需求:安全模式、優先順序、標籤管理、匯出入、multisite 共用、公開雲端片段庫的搜尋下載,這些免費版都有。
該考慮升級 Pro 的情境則相對明確:需要直接在片段裡寫 CSS 或 JavaScript、需要條件式邏輯精準控制程式碼在哪裡執行、經營多個網站需要跨站同步同一批自訂片段,或是希望有 AI 協助讀懂與起草程式碼。這幾項都是免費版目前完全做不到的能力,而不是「免費版陽春、付費版加強」這種模糊的差異。

付費方案是依網站數量分級,提供月付、年付與買斷三種付款週期選擇,另外也有 14 天內的無條件退款保證,不滿意可以在期限內申請全額退款,續訂的費用不在保證範圍內。真正決定要不要升級的,不是價格高低,而是前面這幾項具體能力,自己的網站用不用得到。
