安裝完主題后，頁面中間部分空白/安裝后首頁報錯，500錯誤

如果因為任何原因導致了「啟用主題」失敗， 后續解決了啟用主題失敗的問題，都需要切換到別的主題再切換回來（切換主題過程會清空原來的配置并且還原默認配置），確保默認的設置可以設置成功 ，因為「啟用主題」失敗的時候，默認的初始化數據都沒有設置成功的，會導致主題使用過程中的一些其它問題，比如評論頭像不顯示等等。

• typecho至少為1.0版本，不支持0.9版本?。?！typecho 1.2版本需要使用 handsome8.3 及其以上版本（typecho1.2版本不要使用開發版本，需要使用正式版本，開發版本會在某些服務器上無法保存設置數據）
• 依次檢查主題文件夾名稱是否為 handsome（首字母不用大寫），插件文件夾名稱為 Handsome（首字母大寫）
• 是否已經安裝并且啟用主題必要的插件Handsome

• 服務器環境檢查 ：

  • php版本需要5.6及其以上版本，必須安裝curl、mbstring、openssl、json、zlib擴展 ，否則無法使用（正確檢查方式是在你的服務器新建一個 test.php，然后復制粘貼該代碼 <?php phpinfo(); ?>，最后在瀏覽器訪問該文件可以查看服務器的php信息，一般自己手動編譯的php庫可能會有這個問題）
  • windows 服務器 php 版本請使用 5.6 暫不支持 php7 （目前排查問題可能是 xampp 的某個問題導致，暫時無法解決）。
  • Linux 服務器可以支持 php7、8（php8 需要最新版本主題和 typecho 倉庫的最新代碼）
  • 老薛主機不支持php8，可以使用php7.x 或者php5.6及其以上版本
• 主題目錄給777權限，包括遞歸子文件夾和子文件，也可以嘗試給644或者755權限。因為有的服務器上傳文件之后，默認給的權限php都沒辦法執行的
• 初次使用主題必須保證博客有一篇文章，如果一篇文章都沒有的話會導致向數據庫中添加view（瀏覽次數字段）失敗
• 如果你的 typecho 版本是好久之前的開發版本，需要升級到最新的 typecho 1.2 版本
• 最后確保自己上傳的文件沒有缺失，比如handsome文件夾下有fucntions.php，Handsome文件夾下有Plugin.php 則是最起碼的

Handsome插件無法啟用，顯示Database Query Error

• 原因是文章太多，在首次啟用插件的時候會構建搜索緩存，緩存大小超過了mysql的默認設置
• 在mysql中的控制執行下面的sql語句：

SET GLOBAL max_allowed_packet=4294967295;

如果你裝了phpmyadmin的mysql控制臺面板，在如下圖的位置執行：

如果執行上面語句成功后，還是無法啟用插件，可以參考這里https://blog.csdn.net/wanbin6470398/article/details/81633922 修改innodb_log_file_size 變量的大小，修改值為2G。如果是寶塔面板，就是如下的設置位置，修改配置保存后，再次重啟mysql服務即可。

打開 handsome 外觀設置/插件設置界面顯示后1s后白屏

• 按照上一條中的「服務器環境檢查」檢查服務器配置是否正常
• 檢查 typecho 目錄下的 index.php 或者 config.inc.php 文件最上面是不是自己修改多了空行，或者多了自己添加的注釋
• 確保functions.php 頭部的 //如果需要顯示php錯誤打開這兩行注釋，問題修復后必須關閉！ 這一行注釋下面的兩行是注釋的，上面兩行是沒有注釋的。
• 確認Handsome插件和handsome主題文件夾命名是否正確（Handsome插件文件夾首字母需要大寫，handsome主題文件夾首字母不用大寫），同時確認Handsome插件版本與主題版本一致。
• 檢查typecho 列表中是否錯誤的插件（“此插件文件已經損壞或者被不安全移除，強烈建議你禁用它” 這樣提示的插件需要禁用）

啟動主題后，首頁的樣式不正常（如左側邊欄黑色，很多樣式和我的博客不一致）

• 原因是第一次啟用主題的時候默認的配置沒有初始化成功導致的
• 可以切換到別的主題，再切換回來恢復默認的主題設置即可

啟動主題，主題列表中沒有主題，甚至其他主題都不顯示了

• 主題目錄給777或者755權限包括遞歸子文件夾和子文件 ，Linux是在 usr/themes/目錄下執行 chmod -R 777 ./ 必須包含 -R 參數，表示遞歸執行。
• 檢查typecho 目錄下的 usr/themes/handsome 目錄下是否是一系列主題文件，而不是另一個嵌套的文件夾
• 確定 php 版本是5.6 ~ 8.0，如果是 Windows 服務器嘗試使用低版本 php，如 php5.6

AppNode 面板啟用主題會出錯

該問題是app node 面板版本的是一個bug，具體見：https://bbs.appnode.com/thread-2621.htm

解決方法：

• 找到正在使用的php版本的 php.ini 文件
• 在該文件中搜索 max_execution_time，將后面的值 0d 改成0，不需要后面的單位，然后保存。
• 最后重啟一下php服務， 切記后續不要在面板中修改配置??！ 否則 max_execution_time的值又會變成0d了。

友情鏈接欄目點擊/添加友情鏈接顯示404

依次按照下面操作進行檢查：

• 禁用Handsome插件后再啟用一下試試
• 檢查Handsome插件文件夾首字母是否是大寫
• 重新安裝Handsome插件（刪除舊的Handsome文件夾），確保文件上傳沒有遺漏，沒有漏上傳，自己比較一下下載的本地文件和服務器上的文件是不是一致
• 請勿安裝第三方Links插件 ，如果已經安裝了，先禁用Links插件，再刪除Links插件，最后一樣再按照上面的前三條依次操作檢查。