Drupal 9 添加自定义主题后无法在外观选项卡显示问题求助
Drupal 9 自定义主题未在外观选项卡显示排查方案
- 验证主题存放路径
自定义主题必须放置在站点根目录的themes/custom/路径下,禁止放在core/themes、根目录themes直接层级,否则Drupal不会扫描识别。 - 校验命名规则
主题目录名称仅支持小写字母、下划线,不得包含大写、空格、特殊字符,需和主题机器名完全一致。同时根目录下必须存在和目录名完全同名的.info.yml配置文件,例:目录名为my_theme时,配置文件必须为my_theme.info.yml。 - 检查
.info.yml配置合法性
配置文件必须符合YAML格式规范,缩进仅支持2个空格,禁止使用Tab键缩进,基础必填配置项如下:
重点确认name: 自定义主题展示名称 type: theme description: 主题描述文本 core_version_requirement: ^9 base theme: stable9type字段值为theme,core_version_requirement明确适配Drupal 9版本。 - 清理站点缓存
所有配置修改完成后必须清理Drupal全站缓存,操作路径为后台「配置」-「性能」-「清除所有缓存」,安装了Drush工具的环境可以直接运行命令drush cr完成缓存清理。 - 校验文件权限
确认主题目录及内部文件的权限配置正确,目录权限建议设置为755,文件权限建议设置为644,保证服务器运行用户拥有文件读取权限。 - 排查格式错误
.info.yml存在格式错误时Drupal会直接忽略该主题且不会抛出前台可见报错,可以通过YAML格式校验工具检查文件语法是否正确。
内容的提问来源于stack exchange,提问作者user12401635
相关产品推荐
相关产品推荐

