You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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: stable9
    
    重点确认type字段值为theme,core_version_requirement明确适配Drupal 9版本。
  • 清理站点缓存
    所有配置修改完成后必须清理Drupal全站缓存,操作路径为后台「配置」-「性能」-「清除所有缓存」,安装了Drush工具的环境可以直接运行命令drush cr完成缓存清理。
  • 校验文件权限
    确认主题目录及内部文件的权限配置正确,目录权限建议设置为755,文件权限建议设置为644,保证服务器运行用户拥有文件读取权限。
  • 排查格式错误
    .info.yml存在格式错误时Drupal会直接忽略该主题且不会抛出前台可见报错,可以通过YAML格式校验工具检查文件语法是否正确。

内容的提问来源于stack exchange,提问作者user12401635

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.24 20:24:02