将HTML转为WordPress主题后加载出现白屏问题求助

兄弟，我太懂这种白屏的崩溃感了——明明其他主题好好的，自己做的主题一装就挂，别急，咱们一步步来揪出问题：

• 第一步：开启WP_DEBUG模式，让错误“现身”
  白屏大多是因为PHP致命错误被隐藏了，先打开调试模式看具体问题。找到网站根目录的wp-config.php文件，把这行代码：

  define('WP_DEBUG', false);
  

  修改成：

  define('WP_DEBUG', true);
  define('WP_DEBUG_LOG', true);
  define('WP_DEBUG_DISPLAY', true);
  

  刷新页面后，就能看到具体的错误提示了（比如函数未定义、文件缺失、语法错误），这是排查白屏最关键的一步。

• 第二步：检查主题核心文件的完整性和格式
  WordPress主题必须包含style.css和index.php两个核心文件，而且style.css的头部注释格式要严格正确。你提供的主题信息里Description字段截断了，要注意注释的闭合和格式，比如标准的头部注释应该是：

  /*
  Theme Name: Vesti
  Theme URI: www.komunalacbecej.com
  Author: Aljosa Boskovic
  Author URI: www.komunalacbecej.com
  Description: Twenty Seventeen brings your site to life with immersive featured images and subtle animations.
  Version: 1.0
  License: GNU General Public License v2 or later
  Text Domain: vesti
  */
  

  别漏了开头的/*和结尾的*/，格式错了也会导致主题加载失败。

• 第三步：排查主题文件的语法错误
  重点检查functions.php、index.php这些核心文件，哪怕是一个少写的分号、不匹配的括号都会触发致命错误。可以先把functions.php重命名为functions-old.php，刷新页面试试——如果能正常显示，那就是functions.php里有问题，再逐段排查里面的代码。

• 第四步：排除插件冲突（别嫌麻烦，必须确认）
  把所有插件都禁用，再激活你的主题试试。万一某个插件和你主题里的函数重名、逻辑冲突，也会导致白屏，毕竟其他主题可能没用到这些冲突的函数。

• 第五步：检查文件权限是否正确
  确保主题文件夹权限设为755，文件权限设为644，权限不对的话WordPress可能读不到主题文件，也会出现白屏。

如果做完这些还是没解决，把WP_DEBUG显示的具体错误信息贴出来，咱们再针对性处理！

内容的提问来源于stack exchange，提问作者Aljosa Boskovic