Typo3 v10本地jQuery配置指南——v9升级至v10后TypoScript配置失效解决方法

嘿，我刚处理过TYPO3从v9升级到v10后的jQuery配置问题，确实旧的page.javascriptLibs在v10里已经被完全移除了，得用新的配置项来替代。要加载系统自带的本地jQuery其实很简单，不用自己手动找文件路径，直接用TYPO3内置的资源路径就行，下面给你几种实用的配置方案：

1. 加载jQuery到页面头部（对应原配置的加载位置） #

如果习惯把jQuery放在头部加载，可以用page.includeJSLibs配置：

page {
  includeJSLibs {
    // 指定TYPO3自带的本地jQuery文件路径
    jquery = EXT:core/Resources/Public/JavaScript/Contrib/jquery/jquery.min.js
    // 若不需要将jQuery合并到全局JS文件中，开启这个选项
    jquery.excludeFromConcatenation = 1
    // 对应原配置的noConflict=0，不启用jQuery.noConflict()
    jquery.noConflict = 0
  }
}

2. 加载jQuery到页面底部（推荐，优化页面加载性能） #

更推荐把jQuery放在页面底部加载，用page.includeJSFooterlibs：

page {
  includeJSFooterlibs {
    jquery = EXT:core/Resources/Public/JavaScript/Contrib/jquery/jquery.min.js
    jquery.excludeFromConcatenation = 1
    jquery.noConflict = 0
  }
}

额外说明 #

• 如果需要启用noConflict模式（对应原配置的jQuery.noConflict = 1），只需要把上面配置里的jquery.noConflict = 0改成1即可，TYPO3会自动帮你处理jQuery.noConflict()的调用。
• 路径EXT:core/Resources/Public/JavaScript/Contrib/jquery/jquery.min.js是TYPO3 v10自带jQuery的默认位置，无需修改，除非你替换了系统自带的jQuery文件。
• 如果担心其他扩展重复加载jQuery，可以添加jquery.override = 1来强制使用你配置的这个版本，避免冲突。

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