TYPO3扩展注册TypoScript后引入页面无效果是什么原因？

以下是该问题的常见诱因及对应处理方案：

• 静态模板加载顺序错误
  这是最常见的诱因：TYPO3的静态模板加载顺序是从上到下，后加载的配置会覆盖先加载的同名配置。如果你的自定义扩展模板排在其他定义了page对象的模板之前，你的配置会被后续模板直接覆盖。
  解决方法：进入后台「站点」模块→对应站点的「模板」管理→编辑根模板记录→切换到「包含」标签，将My Project Typoscript条目拖动到已包含模板列表的最底部，确保它最后加载。
• 缓存未清理
  TYPO3会全量缓存TypoScript解析结果，修改配置后如果没有清理全量缓存，前端读取的还是旧的配置内容。
  解决方法：点击后台顶部闪电图标选择「清除所有缓存」，命令行环境可执行typo3 cache:flush完成缓存清理。
• TypoScript配置未实际生效
  首先在后台模板模块的「TypoScript对象浏览器」中筛选page.bodyTag，查看最终生效的配置值：
  1. 若值不是<body class="test">：
     检查myproject_design/Configuration/TypoScript目录下的文件名是否匹配版本要求：TYPO3 12及以上版本默认识别.typoscript后缀，11及以下版本需额外添加同名setup.txt文件做向下兼容。
  2. 若值是<body class="test">：
     说明你的站点Fluid模板硬编码了body标签，没有调用TypoScript的输出配置。找到对应站点的Layout模板文件，将硬写的<body>标签替换为<f:format.raw>{page.bodyTag}</f:format.raw>即可。
• page对象被全量覆盖
  如果其他模板在你之后重新定义了page对象，你的局部配置会失效。可以修改你的setup.typoscript代码，先清空原有page对象再重新定义：

  @import 'EXT:fluid_styled_content/Configuration/TypoScript/setup.typoscript'
  
  page >
  page = PAGE
  page {
      bodyTag = <body class="test">
  }
  

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