如果你剛剛在搜尋「如何在 Typecho 安裝主題」時看到 ShuFeiCat 這個名字,說不定已經有點心動了——它那 200KB 的輕量體態加上免插件的功能,真的很吸睛。
前置準備:確認環境與取得主題檔案
在正式動手之前,先確定你的主機支援 PHP 7.2 以上,且已安裝好 Typecho 核心。接著,前往 GitHub 或官方下載頁面把 ShuFeiCat 的壓縮檔(zip)下載下來。若你使用的是 SSH,直接 git clone https://github.com/yourname/ShuFeiCat.git 也是不錯的選擇,省去手動解壓的步驟。
步驟一:上傳主題檔案
最常見的做法是透過 FTP 客戶端(如 FileZilla)把解壓後的 ShuFeiCat 資料夾上傳至 /usr/themes/ 目錄。如果你偏好指令列,可以在伺服器上執行:
cd /path/to/your/typecho
unzip ShuFeiCat.zip -d usr/themes/
chmod -R 755 usr/themes/ShuFeiCat
上傳完成後,建議檢查一下目錄權限,確保 Web 伺服器有讀寫權限,避免日後出現「無法載入樣式表」的錯誤。
步驟二:在後台啟用並調整設定
登入 Typecho 後台,依序點選「外觀」→「主題」,你會看到剛才上傳的 ShuFeiCat。點擊「啟用」即可看到預設的黑色橫幅與側邊欄。此時可進入「主題設定」調整首頁顯示方式、AI 智能審核的 API 金鑰、Turnstile 防機器人驗證等細節,讓部屬更貼合自己的需求。
常見問題與除錯技巧
1️⃣ 若後台找不到主題,先確認 usr/themes/ShuFeiCat 資料夾名稱是否正確,且 index.php、functions.php 等核心檔案完整。
2️⃣ 出現「404 Not Found」或樣式缺失,往往是 .htaccess 重寫規則未生效,加入 RewriteBase / 後重新整理即可。
3️⃣ AI 智能評論審核無法運作,檢查服務商提供的 API 金鑰是否已啟用「跨域」或「IP 白名單」設定。

評論(15)
200KB這麼小?真的假的,我下個來試試
上傳完找不到主題,原來資料夾名打錯了😭
chmod 755 就夠了?我上次設成 777 才行欸
AI審核還得開跨域?這步驟文章沒寫清楚啊
之前用過類似主題,結果樣式全崩,希望這個穩點
後台啟用完首頁變黑屏…誰遇到過?
輕量是好,但別連基本功能都砍光啊
git clone 那行路徑是不是少寫了?
Turnstile 防機器人比 reCAPTCHA 好用嗎?
剛裝完,速度飛快!黑色橫幅還挺帥👍
.htaccess 加 RewriteBase 就好了?試試看
免插件是真的爽,不用再裝一堆累贅
這主題有支援 PWA 嗎?沒看到說明
感覺比 Handsome 輕多了,先留著備用
上傳權限搞半天,FileZilla 連線老是斷