Drupal 10自定义主题global-styling库无法正常加载求助

我正在基于Drupal 10 Starterkit创建基础主题，想给项目所有页面添加Tailwind CSS。已经配置好Tailwind并遵循Drupal操作步骤，但网站始终无法加载dist/index.css文件。我的Drupal是全新10.1.7版本，无特殊配置，但主题属于安装配置文件，不确定是否影响。已尝试重建主题、重命名、多次清缓存，问题仍未解决。

相关配置文件 #

custom_theme.info.yml #

name: custom_theme
type: theme
'base theme': stable9
starterkit: true
version: VERSION
libraries:
  - custom_theme/global-styling
  - custom_theme/base
  - custom_theme/messages
  - core/normalize
libraries-extend:
  user/drupal.user:
    - custom_theme/user
  core/drupal.dropbutton:
    - custom_theme/dropbutton
  core/drupal.dialog:
    - custom_theme/dialog
  file/drupal.file:
    - custom_theme/file
  core/drupal.progress:
    - custom_theme/progress
core_version_requirement: ^10
generator: 'starterkit_theme:10.1.7'

custom_theme.libraries.yml #

global-styling:
  version: VERSION
  css:
    theme:
      dist/index.css: {}
# ...

排查与解决步骤 #

• 检查文件路径与权限
  确认dist/index.css存在于主题根目录，路径拼写完全匹配（区分大小写）；确保文件及dist目录权限正确，服务器进程需有读取权限（一般设为755目录、644文件）。

• 验证库定义
  在custom_theme.libraries.yml中给dist/index.css添加权重属性，确保优先加载：

  global-styling:
    version: VERSION
    css:
      theme:
        dist/index.css: { weight: -10 }
  

  临时注释其他库，单独测试global-styling是否生效，排查是否有库覆盖冲突。

• 处理安装配置文件中的主题
  确认安装配置文件在安装时正确启用该主题，或手动在后台外观页面将其设为默认主题；检查配置文件中的主题依赖是否完整。

• 缓存与资产排查
  执行完整缓存重建：drush cr（用Drush）或后台“配置->性能”页清空所有缓存；打开浏览器开发者工具“网络”标签，查看CSS请求状态：404为路径/文件问题，403为权限问题，请求未发起则检查库关联或钩子修改。

• 验证Tailwind构建
  重新执行Tailwind构建命令（如npm run build），确认dist/index.css内容正常生成；直接访问CSS文件URL（如/themes/custom/custom_theme/dist/index.css），检查是否能正常加载样式代码。

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