TCEFORM配置的布局类在bootstrap_package前端不生效

以下是针对你遇到的问题的具体排查步骤：

1. 补充布局值到CSS类的映射配置（最可能的原因） #

你仅通过TCEFORM配置了后端的布局选项，但TYPO3需要在TS Setup中把布局数值映射为对应的CSS类名，模板里的{layoutClass}变量正是从这里读取的。

在你的站点包TS Setup文件中添加如下配置（可根据需求调整类名）：

# 内容元素布局映射
tt_content {
    layoutClass {
        0 = layout-default
        1 = layout-product-cards
        2 = layout-alternative-2
        3 = layout-alternative-3
        4 = layout-alternative-4
        5 = layout-alternative-5
        150 = layout-alternative-150
    }
}

# 页面布局映射（若需给页面添加布局类）
pages {
    layoutClass {
        0 = layout-default
        1 = layout-product-cards
        2 = layout-alternative-2
        # 其他布局值对应类名
    }
}

2. 验证TS Setup的加载与优先级 #

• 进入TYPO3后端的模板模块，选择根模板
• 点击「模板分析」，搜索layoutClass，确认你添加的映射配置是否存在，且未被其他扩展/模板的配置覆盖
• 若配置被覆盖，调整站点包TS Setup的加载顺序（确保站点包的TS在其他可能覆盖的配置之后加载）

3. 确认数据库中存储的布局值是否正确 #

• 直接查看数据库的tt_content（内容元素）或pages（页面）表，找到对应记录的layout字段，确认其值是否与你在后端选择的布局一致
• 若数据库存储值正确但前端仍显示默认类，说明映射配置存在问题；若存储值不对，需检查TCEFORM配置的应用范围（比如是否覆盖了目标页面树）

4. 清除全缓存 #

修改TS配置后，务必清除TYPO3的全缓存（包括配置缓存、页面缓存）：

• 点击后端右上角的缓存图标，选择「清除全缓存」

5. 检查模板中layoutClass的赋值逻辑 #

虽然你提到模板已调用{layoutClass}，但可进一步确认变量来源：

• 查看Bootstrap模板的布局文件或对应ViewHelper，确认layoutClass是否确实从TS配置的映射中取值，而非被硬编码为layout-default

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