WordPress 6.0自定义页面模板在编辑页面时不显示

针对你创建page-test.php后在页面属性里找不到模板的情况，按下面的步骤逐一排查：

• 必须添加模板头部注释
  WordPress识别自定义页面模板的核心是文件顶部的特定注释块，你的文件里一定要有这段代码（放在最开头）：

  <?php
  /*
  Template Name: 测试页面模板
  */
  ?>
  `Template Name:`后面的名称会直接显示在模板下拉列表里，别漏写这段注释。
  
  

• 确认文件位置正确
  把page-test.php放在当前激活主题的根目录下，路径类似wp-content/themes/你的主题名称/page-test.php，别放在主题的子文件夹里（比如templates），默认情况下WordPress只会扫描主题根目录的页面模板文件。

• 清理缓存
  WordPress或浏览器的缓存可能导致模板列表没更新：

  • 刷新页面属性的编辑页
  • 清空浏览器缓存后重新登录后台
  • 如果用了缓存插件，清理插件缓存

• 检查文件名和语法

  • 确认文件名是page-test.php，没有拼写错误（Linux服务器上文件名大小写敏感，别写成Page-Test.php）
  • 检查文件里的PHP代码有没有语法错误，比如括号不匹配、少分号，语法错误会让WordPress跳过这个模板。可以先把文件简化成只有头部注释和空的HTML结构，测试能不能显示。

• 子主题/父主题验证
  如果用的是子主题，确保文件放在子主题目录；如果是父主题，确认当前激活的就是这个主题。

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