自定义WordPress主题未在wp-admin后台显示问题求助

1. 校验主题存放路径正确性 #

• 打开Local对应站点的详情页，点击「Go to site folder」进入站点根目录，确认自定义主题文件夹直接放在app/public/wp-content/themes/路径下，不可嵌套在其他子文件夹内。
• 主题文件夹命名避免使用中文、空格、特殊字符，建议采用全小写+短横线分隔的格式，例如my-custom-theme。

2. 确认style.css头部注释合规 #

• style.css必须放在主题文件夹根目录，且头部的主题声明注释需写在文件最顶部，前面不能有任何空白字符、PHP代码或其他内容，必填的基础注释格式如下：

/*
Theme Name: 自定义主题名称
Version: 1.0
Description: 主题功能描述
Author: 开发者名称
License: GPLv2 or later
Text Domain: 主题文本域
*/

• 其中Theme Name是WordPress识别主题的必填字段，不可遗漏。

3. 清理多层缓存解决已删除主题仍显示问题 #

该现象90%由缓存未清空导致，按顺序执行以下操作：

• 登录WordPress后台，若安装了缓存插件先清空所有站点缓存，无缓存插件可手动删除wp-content/cache目录下的全部文件。
• 回到Local站点详情页，先点击「Restart」重启站点，再点击「Clear cache」清除Local层面的站点缓存。
• 若使用APFS格式的Mac磁盘，可执行diskutil apfs purgeCache命令清除系统文件缓存，或直接重启设备后再查看后台主题列表。

4. 校验文件权限配置 #

• 右键主题文件夹选择「显示简介」，在底部「共享与权限」板块确认：文件权限不低于644，文件夹权限不低于755，避免因权限不足导致WordPress无法读取主题文件。

5. 修复Local站点配置异常 #

若以上操作全部执行后问题仍存在，可右键Local内的对应站点选择「Export」导出备份，删除原有站点后重新导入备份，修复可能存在的站点配置损坏问题。

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