TYPO3 12.4.13+ws_scss 12.0.5：Bootstrap SCSS无法生成CSS求助

环境信息 #

• TYPO3版本：12.4.13
• ws_scss版本：12.0.5
• 开发环境：macOS + DDEV + Composer

当前TypoScript配置 #

page.includeCSS {
    bootstrap = EXT:mein-sitepackage/Resources/Private/Scss/base-layout.scss
    bootstrap {
        inlineoutput = false
        outputdir = typo3temp/assets/css/
    }
}

已尝试的方法 #

• 切换inlineoutput参数为true或false
• 更换outputdir路径（包括EXT路径、fileadmin路径等）
• 使用outputfile参数替代outputdir

排查步骤与解决方案 #

• 修复目录权限：DDEV容器内Linux环境对权限敏感，确保输出目录存在且可读写。执行以下命令：

  ddev exec mkdir -p typo3temp/assets/css/
  ddev exec chmod -R 775 typo3temp/assets/
  ddev exec chown -R www-data:www-data typo3temp/assets/
  

• 校验SCSS文件路径与大小写：macOS不区分文件名大小写，但DDEV容器内是Linux环境，需确保base-layout.scss路径、文件名完全匹配，且文件真实存在于扩展目录中。
• 启用调试模式获取错误信息：在TypoScript中添加调试配置，查看系统日志定位问题：

  plugin.tx_wsscss.settings.debug = 1
  

  然后进入TYPO3后台“系统>日志”查看ws_scss相关报错，或检查前端控制台输出。
• 手动验证SCSS语法：在DDEV容器内安装sass工具并编译测试，排查语法错误：

  ddev exec npm install -g sass
  ddev exec sass typo3conf/ext/mein-sitepackage/Resources/Private/Scss/base-layout.scss typo3temp/assets/css/test.css
  

  若命令报错，根据提示修复SCSS文件中的语法问题。
• 彻底清理TYPO3缓存：执行缓存清理命令，确保配置生效：

  ddev exec typo3 cache:flush
  

  也可通过后台“维护>清理缓存”清理所有缓存类型。
• 检查配置是否被覆盖：进入TYPO3后台“模板>设置>查看完整配置”，搜索page.includeCSS.bootstrap，确认最终生效的配置与你编写的一致，避免被其他模板或扩展覆盖。

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