WordPress 佈景主題安裝：三種路線怎麼選、怎麼驗收

想像一個場景：一間選品店的週年檔期後天上線，主理人上週就買好了新佈景主題，登入後台準備安裝，卻在「外觀」選單裡翻來翻去，就是不見上傳按鈕的蹤影。她清了快取、換了瀏覽器，開始懷疑自己買到問題檔案。主題沒問題，帳號也沒問題，問題出在她站上的平台與方案，從一開始就不會給她這顆按鈕。

安裝佈景主題常被想像成「安裝一套軟體」，實際發生的動作樸素得多：把一個資料夾放進伺服器的 wp-content/themes/ 目錄，再讓資料庫裡的一筆設定決定由哪個主題輸出前台。三條安裝路徑也常被當成三種難度等級，其實只是三種把檔案送進伺服器的方式，終點相同。看清這一層，按鈕消失、裝了沒反應、更新之後客製內容全部消失，就都不是玄學，而是能一步步推回原因的因果。

順序因而要倒過來：判斷先於點擊。四個問題構成判斷的骨架：你拿到的主題是什麼檔案形態？環境許不許你裝？裝了為什麼可能沒反應？怎麼確認沒有裝壞？三條安裝路徑與各種疑難情境，都掛在這四問上，以下依序展開。

快速重點：裝一套佈景主題，其實只是把一個資料夾放進伺服器，再由一道資料庫開關決定誰上場。後台搜尋、上傳 ZIP、SFTP 放檔終點相同，差別只在檔案怎麼進伺服器。路徑由主題來源決定，裝完要點啟用才生效，上線前跑完版面、效能、搜尋、商業流程四組檢查。

你拿到的主題，是哪一種檔案？

先看檔案，再開後台。主題從哪裡來、以什麼形式交付，直接決定該走哪條安裝路徑；順序反了，就會在錯的畫面裡空轉，把環境問題誤判成主題問題。

實際判斷花不了幾分鐘。設計師移交的站，先打開交付的資料夾，看有沒有兩層命名相近的資料夾，或一份標頭帶有 Template 欄位的 style.css，有就表示客製已放進子主題，日後照著更新即可；市集下載的整包檔，先解開瀏覽一遍，認出哪個壓縮檔才是主題本體，它通常與示範內容、外掛、說明文件並排放著。這幾分鐘的判讀，決定你之後按的是哪顆按鈕。

無論哪一種形態，WordPress 認主題的方式只有一個：主題資料夾根目錄裡的 style.css，開頭有一段標頭，登記主題名稱、版本等欄位，這是主題的身分文件。官方開發文件的入門章節對這段標頭有完整說明。日後若在上傳時收到「找不到有效的佈景主題」這句回應，原因多半是這個檔案不在你上傳的那一層，而非主題損壞。

分工也順帶講清楚：主題管呈現，外掛管功能。版面跑掉先查主題，表單送不出先查外掛，排錯方向才不會整組歪掉。兩者的安裝流程幾乎同構，對照外掛的安裝流程可以一次建立起整體感。

會不會需要客製，同樣要在這個階段想清楚。只要有人會直接修改範本檔案，子佈景主題就該列進計畫，而不是裝完再補。判斷的產出不是一個結論，而是一張清單：主題形態、是否附外掛、是否需要子主題、之後由誰維護。挑主題時，目錄上的更新時間與支援狀態是線索，篩選的評估角度可先看過佈景主題的挑選比較一輪，帶著清單進後台，每個畫面對你才有意義。

按鈕不見、上傳被擋：先做環境體檢

後台找不到上傳鈕，多數時候不是故障，而是邊界。三個環境變數決定你能不能裝：平台是自架還是託管、帳號角色有沒有安裝權限、主機允不允許寫入。

平台是第一個變數。WordPress 在全球使用內容管理系統的網站裡占比很高（依 W3Techs 的長期統計），但這個名字其實指著兩種產品：WordPress.org 是你租主機、自己安裝的軟體，檔案系統完全屬於你，三條安裝路徑全部可用，還沒架站的人可先把從零安裝 WordPress 的完整流程走一遍；WordPress.com 是平台代管，功能依方案分級，免費方案沒有第三方主題的上傳入口，付費方案才逐步開放，這點在 WordPress.com 的官方支援文件寫得很明白。兩種 WordPress 的完整差異已有專文逐項拆解。這條邊界源自商業模式，理解它，就不會把找不到按鈕誤判成故障。

快速確認自己屬於哪一種，看網站在哪裡管理，而不是看網域：兩種都掛得上自有網域、也都進得了 wp-admin，登入路徑分不出來。在 wordpress.com 帳號的「我的網站」清單裡管理、帳單與方案都走 wordpress.com 的，是託管站；檔案放在自己租的主機、由主機控制台經手的，是自架站。方案與可用功能清單在帳號頁面看得到，不必猜。

帳號角色是第二個變數：只有管理者等級能安裝主題，編輯或作者看不到入口屬正常設計。主機寫入權限是第三個：安裝動作需要 WordPress 能寫入 wp-content 目錄，主機權限設得過嚴時，畫面會回報「無法建立目錄」一類錯誤，這屬環境問題，重試不會好，要從主機端解。還有一種少見情況是管理外掛改造了後台選單、把入口藏起來，換另一個管理者帳號登入比對，很快能分辨。

體檢的順序建議由外而內：平台、帳號、主機。越外層的邊界越像「什麼都沒發生」，平台不給按鈕不會有任何錯誤訊息，權限不足也只是選單少一塊；反而是內層的主機寫入問題會明確報錯。由外而內走一遍，「沒反應」與「報錯誤」就能分別對應到不同層，不會一開始就往難的方向鑽。

官方目錄直裝，從搜尋到啟用一次完成

主題若收錄在官方目錄，這是最短的一條路。從左側的「外觀」進到佈景主題頁，再開啟「安裝佈景主題」，輸入名稱搜尋，點「安裝」，等進度跑完；中途不必離開瀏覽器，也不碰任何壓縮檔。官方對這個畫面的說明文件，同一頁就寫完從搜出、裝上、預覽到啟用的整段動線。

搜尋結果頁本身有判讀價值。篩選器能按功能與版型過濾；結果卡片上的「預覽」讓你先看到裝上去的樣子，不必真的安裝。評價可以看，但要看內容而不只看星等：一則具體描述問題與回應的負評，比幾十個空泛好評更有參考價值。這些工具縮短的是判斷時間，最終的取捨仍要回到自己網站的需求。

裝完先停一下。按鈕變成「啟用」不等於要立刻按下去，啟用之前還有預覽與準備的功夫，後面會展開。第一次摸索後台的讀者，搭配後台介面的導覽建立起整體地圖，操作會順很多。

目錄本身值得花兩分鐘認識：官方主題目錄收錄的主題都經過基本審查，審查是入場門檻，後續維護與安全仍要自己盯。免費與否也不是品質的分界：目錄裡有維護良好的長青款，付費主題也有長期不更新的例子，開發者還在不在，更新紀錄與支援區的活躍度比價格更能回答。篩選條件與安裝量都只是線索，正式站要用的主題，先在測試環境裝一輪。

有 ZIP 檔的人，上傳安裝與兩個常見失誤

從開發商或市集取得的主題，交付形式是 ZIP 壓縮檔。同一個「安裝佈景主題」頁面，改從「上傳佈景主題」這顆按鈕進入，選檔、送出，系統自行解壓並登記主題。購買前的授權範圍與更新條件，可對照付費主題的購買檢查清單先核一遍，免得裝了才發現授權人數或更新期限跟預期不同。

這條路上常見的失誤有兩個。其一是自己解壓後又重新壓縮：系統判斷的是壓縮檔解開後的結構，重新打包常會多包或少包一層資料夾，讓最上層不是主題資料夾、style.css 不在根目錄，於是畫面跳出「找不到有效的佈景主題」的訊息。維持原始 ZIP 上傳最省事；真要自行打包，先解開確認一層資料夾的根目錄就是 style.css 再傳。

其二是誤傳整包交付檔。第三方下載常把主題、說明文件、示範內容與搭配外掛包成一個大 ZIP，整包直接上傳，系統在同樣的位置找不到主題身分，錯誤訊息一模一樣；解開外層、找到主題本體的那個 ZIP 再傳，就過了。訊息相同、原因不同，這正是先判斷檔案形態的價值。

上傳成功後，畫面會提供「啟用」與「即時預覽」兩個動作，原則與其他路徑一致：先預覽，後啟用。付費主題的授權常與網站數量綁定，客戶站要用的主題，授權就該登記在客戶名下或以專案方式取得，維護者共用一張授權，日後客戶接手或終止合作時容易起爭議，購買當下寫進報價與合約，比事後協調省事。

還有一個與檔案好壞無關的關卡：單檔上傳的大小限制屬於主機設定，畫面提示檔案超過限制時，請主機調整，或者改走下一節的 SFTP。挑主機時把這類彈性算進去，主機類型的選擇適合先看。成功訊息出現後，主題已登記進清單，接下來的動作與其他路徑完全一致，沒有第二套規則要學。

當後台幫不上忙：SFTP 手動放置主題

三種情況需要繞過後台，直接動伺服器檔案：

• ZIP 超過主機的單檔上傳限制，又不想為此改主機設定。
• 網站白畫面，連後台都進不去，需要從檔案端救援。
• 主機權限擋住寫入，後台安裝一路回報錯誤。

這條路的定位不是進階技巧，而是後台失效時仍然成立的一條退路：壓縮檔先解開成一個資料夾，經由主機的檔案管理器，或以 SFTP 建立一條加密連線，把資料夾送進 wp-content/themes/ 這個固定位置。連線一律挑加密協定，會把帳號密碼以明文送出的舊式 FTP 不列入考慮；傳輸工具的逐步操作，檔案傳輸的完整教學有整段示範。

方向要記牢：與 ZIP 上傳相反，先解壓、再放資料夾。解開之後先做檢查：style.css 要位在資料夾的最上層；傳統主題多半另附 index.php，區塊主題則以 templates/index.html 為必要檔案，實際要求隨主題類型而有別。資料夾放定位，回到後台的佈景主題清單就會看到它，點啟用即完成。

工具選擇上，偶爾傳一個主題，主機內建的檔案管理器就夠用；經手網站多的人，桌面端 SFTP 軟體的續傳能力與本機目錄對照會順很多。連線資訊由主機提供，存進密碼管理工具，不進聊天訊息與電子郵件。上傳整個資料夾需要一點時間，完成後重新整理後台的佈景主題頁即可看到。

救援場合，順序本身就是安全裝置：先確定手上有一份還得回去的備份；接著把出狀況的主題資料夾換個名稱，隔離在 WordPress 的視線之外。系統的退路是預設主題：站上若有可用的 WordPress 預設主題，輸出有可能切到它繼續（不會自動回到你先前的選擇），但這條退路不保證啟動，若未切換或畫面仍無法輸出，依備份還原是最穩的退場；原因則到主機錯誤紀錄裡回頭追。刪除是留到備份確認之後的動作，一個檔案都不要太早丟；權限數值不抄網路上的通用數字，主機文件怎麼寫就怎麼設。

裝了卻沒反應？安裝與啟用之間隔一道開關

檔案明明進了伺服器，前台一寸不動，原因通常只有一個：還沒點啟用。安裝只是把主題登記進清單；啟用才改寫資料庫裡的目前主題設定，讓前台輸出換手。整個網站任何時刻，就只有一個主題實際在跑。

畫面上分辨這兩個狀態並不難：佈景主題清單裡，正在運作的主題會標示使用中，其餘的只是存在。停用不會刪除主題，檔案仍留在伺服器上；真正移除要按刪除，而刪除前先確認它是誰、有沒有子主題掛在它身上，因為父主題一刪，子主題就跟著失效。

清單裡可以同時存在多個主題，但多裝是有成本的。閒置主題仍要跟著更新，每一個都是安全事件發生時得多看一眼的對象，後台清單也會越積越亂。沒有用途的舊主題，確認可還原之後就移除。

啟用前先用預覽。傳統主題的即時預覽在自訂器裡，區塊主題的預覽則換到網站編輯器進行，畫面樣式隨版本與主題類型而異；預覽像一個安全場域，把外觀與設定看過一輪、調整到位，再正式啟用，出事的範圍會小得多。預覽的另一個價值是比較：新舊主題的選單結構、小工具區域數量差多少，在預覽裡一目了然，正式啟用後要搬哪些東西、花多少時間，心裡也估得出來。

啟用之後三個後遺症要盯：選單要重新指派，新主題的位置命名不同，對應做法見選單位置的設定；小工具要重新歸位，舊區域的內容會被暫時保留，整理方法見小工具區域的搬移指南；首頁顯示設定可能被重置回文章列表，到「設定 → 閱讀」指回原本的靜態頁面即可。主題與外掛的安裝機制同構，一邊累積的經驗可以直接搬到另一邊。

換主題是變更管理，不只是按按鈕

正式站換主題，性質上是一次變更管理。事前三件事，成本遠低於任何一次事故處理：備份並驗證可還原、記錄現行狀態、盤點關鍵外掛的相容性。

備份要同時涵蓋檔案與資料庫，並確認還原流程真的走得通；還原不了的備份只是心理安慰。備份與還原的完整流程適合在沒有壓力的日子先演練一次。

記錄現況的做法很土，但有效：截圖或筆記記下目前的主題、選單掛在哪個位置、首頁指向哪一頁。紀錄範圍再加一項：目前啟用中的外掛清單與版本。回溯問題時，知道當時裝了什麼，跟知道當時長什麼樣一樣重要；新主題啟用後若首頁跑掉、選單錯位，這份紀錄就是對照基準，不靠記憶還原。

外掛盤點聚焦在與呈現深度綁定的那幾個：頁面編輯器、表單、購物車。新主題一旦與其中之一不相容，啟用那一刻就是破版或報錯；先到新主題的文件與支援區查一輪，比出事後回頭排查省力。PHP 版本也在這時確認，「工具 → 網站狀態」看得到目前版本，對齊仍在安全支援範圍的版本。盤點的起點，可以拿常用外掛清單來對照。

時機也是變更管理的一部分。挑流量低的時段動工，先把維護頁或公告準備好，預留一段能親自盯著網站的時間再按啟用；換完的兩三天，多看幾次前台與表單收信，確認沒有延遲發作的問題。這些安排不改變技術結果，卻決定出事時你是在從容回應，還是在加班搶救。

子佈景主題：讓客製內容活過主題更新

直接修改主題檔案的人，遲早會遇到這一天：主題推出更新，按下更新鈕，改了好幾個月的配色與版面整批消失。這不是更新出包，是設計如此。主題更新以「父主題不可修改」為前提整批換檔，覆蓋你的修改屬於它的正常行為；要讓客製內容活過更新，就把它放進另一個地方：子佈景主題。

覆寫的規則是挑檔案，不是改檔案：子主題放進同名範本，輸出那個頁面時就改用子主題的版本；functions.php 是唯一例外，子與父同時載入，自訂函式放子主題即可生效，不必把父檔整份複製過來。樣式表要不要額外載入，取決於父主題的載入方式；啟用子主題後，父主題仍須留在伺服器上。

不少商業主題的下載包裡，另附一份可直接安裝的子主題 zip，先裝哪一個、內容長什麼樣，以原開發商的文件為準；實際動手時可對照 Astra 建立子主題的步驟，想直接採用現成方案的人，也可以看 Divi 子主題的揀選要點。它的價值在分層收納：自訂樣式、範本覆寫、functions 層的修改，都放在子主題自己的資料夾裡，父主題改版換檔時碰不到這一層；不過分開收納不等於永久免檢，父主題更新之後，相容性要回頭重新驗一輪，父子兩邊的檔案一有增減，覆寫出來的結果就可能跟著不同。

不是每個網站都需要子主題。調整只透過後台的額外 CSS、網站編輯器或外掛完成時，可以不做；一旦動到範本或功能檔案，它就是必要工法。最小的子主題只需要一個新資料夾，加上一份在標頭以 Template 欄位宣告父主題的 style.css，安裝方式與一般主題完全相同，清單裡啟用它即可生效。

更新後的驗證也有省力的做法：父主題推出更新時，先在測試環境更新，把主要頁面點過一輪，沒問題再到正式站更新；站上沒有測試環境，至少把更新排在能立刻處理回報的時間，並在更新前替子主題資料夾留一份副本。子主題擋的是覆蓋，不是變更本身，父子組合改變後的行為，仍要靠人確認。

示範內容的真相：你匯入的是資料，不是設計

主題裝好，網站卻跟官網展示差一大截，這不是裝錯。官網那個成品樣貌，靠的是另一批匯入進來的內容素材：頁面、媒體、選單與相關設定組合而成；主題交到你手上的，只有工具。想接近展示的樣子，得再執行一次匯入，而匯入帶進來的是資料，設計早就包在主題裡。理解這個區分，採購時的期待就會準確：付費買的是工具與更新服務，展示內容多數不在交易範圍裡，它是行銷素材，幫你想像成品，而不是隨貨附贈的成品；也有產品把示範模板列為付費項目，實際交付範圍依各家的授權條款認定。

匯入入口的位置依主題而異，共通的邏輯是在主題設定面板裡找 Demo Import、Starter Sites 一類的頁面，挑版本、按匯入，主題代為建立對應的頁面與媒體，過程需要幾分鐘，視主機效能與圖片數量而定。想經營內容媒體的人，先用新聞網站的經營架構看過一輪，對匯入後的內容規模會比較有底。

匯入前還有一張前置清單：不少主題的示範內容依賴指定外掛才有那些版面與功能，文件通常會列，先裝齊再匯入，成功率與清理都乾淨；重複匯入同一份示範內容，預設會再多出一套頁面與媒體，負擔跟著加倍；部分匯入工具（例如 Starter Templates）提供先移除前次匯入內容的選項，實際行為依工具設定而定，動手前想清楚要哪一個版本。

三個提醒。匯入前先備份：這個動作會一次生出大量頁面與媒體，成果不滿意時逐項清理相當耗工，備份在手，一次還原就能退回匯入前的狀態。示範內容挾帶的圖片僅供佔位，能下載不代表取得商用權利，上線前請換成自己的素材。匯入是起點不是終點：假文字配上模特兒照的空殼站，是匯入後最常見的尷尬場面。

工具相依也要看清。示範內容若綁定某套頁面編輯器的專屬格式，往後就只剩相容工具能編，等於提前決定了長期留在站上的編輯器；Elementor 的完整操作與各家頁面編輯器的比較可以對照著看。媒體類站點選了 Newspaper 這套主題的話，從匯入到版面調整的細節有分段拆解；以 JNews 經營雜誌式內容站的人，該主題的變現設定教學能接手示範內容落地之後的客製化工程。

怎麼確認沒裝壞？上線前的四組檢查

啟用之後、對外之前，四組檢查跑完才算真的裝好。內容都存放在資料庫，換主題改變的是輸出層，檢查重點也就放在輸出：版面、效能、搜尋、商業流程，各一組。

版面組：每一種頁面都實際點過

首頁、單篇文章、一般頁面、分類與標籤彙整、搜尋結果、404 錯誤頁，每種版型都實際點開；手邊的手機也要親自滑過一輪。行動裝置占全球網站流量的比例長期過半（依 Statista 的全球流量統計），但測試裝置仍應以自己的分析資料為準。檢查時用無痕視窗開網站，避免快取把破版遮住；順手點選單裡的連結走到第二層頁面，導覽動線的問題常藏在深處。跑版時的判斷依據，可以回到響應式設計的基本原則。

效能組：把成本來源分開看

用 PageSpeed Insights 量一次，分數參考就好，重點是把成本拆開：主題載入的樣式與腳本、圖片、第三方服務各占多少。Google 在 web.dev 的說明對速度與使用者行為的關係有直接交代。換主題前後各量一次，差異才知道多少來自主題本身，多少來自原本就存在的圖片與腳本；先看組成再決定要不要處理，比盯著總分有意義。

搜尋組：輸出格式與索引狀態

重要頁面的標題與 meta 描述輸出格式對一遍，特別留意 SEO 外掛與主題的重複輸出；HTTPS 頁面裡不能再出現 http 資源，混合內容的處理見HTTPS 的基本觀念。網址結構原則上不因換主題而變，選單變動卻會牽動內部連結動線，判斷框架見網址路徑的結構。結構化資料用 Rich Results Test 驗證，缺少標記不等於必然失去能見度，不必恐慌。完整的檢查邏輯收在WordPress SEO 的整體架構；索引與檢索狀態先從Search Console 的設定做起，之後定期回Search Console 的報告看異常。

商業流程組：把賺錢的路徑走完

聯絡表單實際送一次，確認信件到得了；電商站從商品、購物車到付款通知，完整走一次結帳。WooCommerce 是廣泛使用的電商系統（依 W3Techs 的統計），結帳頁對主題樣式與腳本的依賴深，是換主題後最值得親自驗證的一頁。測試訂單完成後，把測試資料清除或標記，別讓它混進真實報表。流量與轉換的長期變化沒有人能掛保證，但流程能不能用，當下測就知道。

症狀速查：卡關時先對這張表

卡關時，先在螢幕上找到你看到的那句話，再對表。原因欄刻意標示「問題出在哪一層」，因為同一句錯誤訊息可能來自不同層，分層比衝動重試快。

白畫面值得單獨說明，因為它的因果鏈最長：安裝與啟用都成功了，是新主題的範本與功能檔在載入階段接手輸出時，因為 PHP 版本不符或與某個外掛衝突而中斷。處理順序固定：確認備份可還原，把新主題資料夾改名隔離；站上若有可用的 WordPress 預設主題，系統可能切換至它維持輸出（不會自動回到先前的主題），若未切換或畫面仍無法輸出，依備份還原，再查錯誤紀錄找真正的原因。動手救援之前先備份，未備份不刪檔，兩條紀律適用於表上每一列。

錯誤紀錄的位置依主機而異，常見在主機控制台的紀錄區，或透過 WordPress 的除錯設定輸出；看不懂整段紀錄沒有關係，把發生時間點附近的幾行原文留著，貼給主機支援多半能快速定位。表上每一種情境，都在前面某一節有完整因果，回頭讀那一節，通常比到處搜尋更快。

從判斷到驗收：一套最小的安全流程

把整套流程收斂成一個可以照走的順序，每一步都回指某一層機制；出問題時，回頭查那一層。

1. 備份檔案與資料庫，確認還原流程可用。備份是所有救援動作的前提。
2. 記錄現行主題、選單與首頁設定。這份紀錄是啟用後的輸出對照基準。
3. 確認平台、帳號角色與主機寫入權限。環境邊界先畫清楚，路徑選擇才有效。
4. 判斷主題的檔案形態並選定路徑：目錄內直裝、ZIP 上傳，或 SFTP 放置。路徑由來源反推，與偏好無關。
5. 在預覽裡調整選單、小工具與首頁設定。預覽是啟用前的安全場域。
6. 點啟用，讓資料庫裡的目前主題設定換手，前台輸出移交給新主題。
7. 需要時匯入示範內容，記得匯入的是資料，素材要替換。
8. 跑完版面、效能、搜尋、商業流程四組檢查，全過才算裝好。

介面會改版，按鈕位置會移動，這些細節都會過時；檔案放置、資料庫設定、載入階層、權限邊界這四層機制，長期適用。同一套四問也能搬到別的安裝類操作：外掛、語言包、圖案集合，先問檔案形態與環境，再確認啟用狀態，用輸出驗收。把備份、預覽、驗收內化成換主題時的反射動作，比背下任何一份點擊路徑可靠。

想往上下游延伸的讀者：從零架站的完整流程涵蓋主題之前與之後的所有環節，趕時間的人先用快速架站的順序跑一輪，動手前則可拿網站成本的組成把預算看清楚。