TYPO3 9.5扩展中setup.txt/setup.typoscript无法加载求助

我之前开发TYPO3扩展时也碰到过类似的TypoScript加载失败问题，结合你的描述，咱们一步步排查解决：

1. 确保静态模板已被添加到根模板 #

你已经通过ExtensionManagementUtility::addStaticFile注册了静态模板，但这只是把模板“注册”到系统里，必须手动在后端根模板中包含它才会生效：

• 进入TYPO3后端的「模板」模块
• 选择你的根站点对应的模板记录
• 点击「编辑整个模板记录」
• 切换到「包含静态模板」标签页
• 在「可用的静态模板」里找到你的Energieportal Frontend模板，添加到「已选的静态模板」列表中
• 保存模板记录

2. 修复TypoScript语法错误（核心问题！） #

看你写的additionalHeaders配置，这里有语法错误：

// 错误写法：用了大括号赋值给additionalHeaders
additionalHeaders = {
  10 {
    header = Content-Type: application/json
    replace = 1
  }
}

正确的写法应该是直接配置additionalHeaders的子属性，不需要外层的=和大括号：

// 正确写法
additionalHeaders {
  10 {
    header = Content-Type: application/json
    replace = 1
  }
}

这个语法错误会导致整个setup文件解析失败，后续的ajax_ajaxjson和testvar自然都加载不出来。

3. 检查文件路径与命名 #

• TYPO3 9.5推荐使用.typoscript后缀（setup.typoscript），setup.txt也兼容，但要确保路径完全正确：EXT:energieportal/Configuration/TypoScript/setup.typoscript
• 注意路径的大小写！Linux服务器上TYPO3对路径大小写敏感，比如Energieportal和energieportal是不同的，要和你的扩展key完全一致。

4. 强制清除所有TYPO3缓存 #

修改TypoScript或配置文件后，一定要清除所有缓存，否则旧的配置会一直生效：

• 后端点击顶部栏的「清除缓存」→「清除所有缓存」
• 或者用命令行（Composer安装的TYPO3）：./typo3cms cache:flush

5. 验证TypoScript加载情况 #

用TYPO3的内置工具确认模板是否加载：

• 模板模块中，点击「模板分析」，查看「已加载的模板」列表，确认你的扩展setup文件在其中
• 用「TypoScript对象浏览器」搜索ajax_ajaxjson或testvar，如果能找到，说明加载成功；如果找不到，回到前面的步骤排查。

6. 确认testvar的定义 #

如果要测试<f:cObject typoscriptObjectPath="testvar"/>，需要在setup.typoscript中明确定义这个对象，比如：

testvar = TEXT
testvar.value = 测试变量内容

按照上面的步骤排查，应该就能解决你的问题了。

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