本教程详细阐述了如何在WordPress网站中正确移除由Google CDN加载的jQuery脚本。针对因重复加载、性能瓶颈或版本冲突导致的问题，文章指出了常见的错误尝试，并提供了使用`wp_deregister_script('jquery')`的正确方法。通过清晰的代码示例和最佳实践，指导用户有效管理WordPress中的jQuery依赖，从而提升网站性能和稳定性。
引言：WordPress中移除Google CDN jQuery的必要性
WordPress在默认情况下会加载jQuery库，有时会通过Google CDN来提供。虽然CDN加速有助于全球用户访问，但在特定情况下，这可能导致一些问题：
- 性能瓶颈：尽管CDN通常很快，但外部资源的加载仍可能引入额外的DNS查找和HTTP请求延迟，有时甚至比本地托管的脚本慢。
- 重复加载：如果您的主题或某些插件已经包含了另一个jQuery版本（无论是本地托管还是来自其他CDN），WordPress默认加载的Google CDN jQuery就会造成重复加载，浪费带宽并增加页面渲染时间。
- 版本冲突：不同版本的jQuery可能存在兼容性问题，导致网站功能异常或JavaScript错误。
当您网站上已存在一个jQuery脚本，且希望避免WordPress重复加载Google CDN提供的版本时，了解如何正确禁用它是至关重要的。
理解WordPress默认的jQuery加载机制
WordPress通过其脚本管理系统（wp_enqueue_script和wp_deregister_script等函数）来处理JavaScript库的加载。它为许多常用库（包括jQuery）注册了句柄。对于jQuery，WordPress内部注册的句柄是jquery。当WordPress需要加载jQuery时，它会查找这个句柄并根据配置（例如，是否启用了CDN）加载相应的脚本。
常见的错误尝试与正确方法
许多用户在尝试禁用Google CDN jQuery时，可能会错误地使用wp_deregister_script('jquery-js')这样的句柄。然而，WordPress内部用于jQuery的正确句柄是jquery，而不是jquery-js。因此，尝试注销一个不存在的句柄将不会有任何效果。
正确的方法是使用wp_deregister_script('jquery')来注销WordPress默认注册的jQuery脚本。
正确移除Google CDN jQuery的步骤
要从您的WordPress网站中移除由Google CDN加载的jQuery，您需要将以下代码添加到您的主题的functions.php文件中。
代码解释：
- custom_deregister_google_jquery()：这是一个自定义函数，用于包含我们的注销逻辑。
- if ( ! is_admin() )：这个条件判断非常重要。它确保了我们的代码只在网站的前端执行，而不会影响到WordPress的管理后台。管理后台依赖WordPress自带的jQuery版本，禁用它可能会导致管理界面功能异常。
- wp_deregister_script('jquery')：这是核心操作。它告诉WordPress注销其内部注册的名为jquery的脚本。一旦注销，WordPress就不会再尝试加载这个脚本，包括通过Google CDN加载的版本。
- add_action( 'wp_enqueue_scripts', 'custom_deregister_google_jquery' );：这行代码将我们的自定义函数挂载到wp_enqueue_scripts动作钩子。wp_enqueue_scripts是WordPress推荐用于在前端页面加载或管理脚本和样式的钩子。确保在脚本被加载之前执行注销操作。
可选：替换为自定义jQuery版本
如果您不仅想移除Google CDN的jQuery，还希望替换为自己特定版本（例如，本地托管的版本或另一个CDN的特定版本），您可以在注销之后，立即注册并加载您的自定义版本。
以下示例展示了如何移除WordPress默认的jQuery，并替换为本地托管的jQuery 3.6.0版本：
重要提示：
- 请确保get_template_directory_uri() . '/js/jquery-3.6.0.min.js'路径指向您实际的jQuery文件。
- 使用相同的句柄jquery可以确保任何依赖于WordPress默认jquery句柄的插件或主题脚本能够找到并使用您提供的jQuery版本。
注意事项与最佳实践
- 备份functions.php：在修改主题的functions.php文件之前，务必进行备份。错误的修改可能导致网站无法访问。
- 使用子主题：强烈建议通过子主题的functions.php文件进行修改，而不是直接修改父主题。这样可以避免在主题更新时丢失您的更改。
- 检查依赖性：在移除或替换jQuery后，务必仔细检查您的网站功能。某些主题或插件可能对特定版本的jQuery有严格的依赖，或者它们可能在自己的脚本中硬编码了对特定jQuery版本的引用。
- 测试：在生产环境应用更改之前，务必在开发或 staging 环境中彻底测试网站的所有功能，特别是那些依赖JavaScript的部分。检查浏览器控制台是否有JavaScript错误。
- 缓存清除：进行更改后，请清除所有网站缓存（包括WordPress缓存插件、CDN缓存和浏览器缓存），以确保新的配置生效。
- CDN与本地托管的选择：如果您选择替换jQuery，请根据您的用户群体和性能需求，权衡使用CDN（例如jsDelivr, Cloudflare CDN等）还是本地托管。CDN通常能提供更好的全球分发速度，但本地托管可以更好地控制版本和减少外部依赖。
总结
通过正确使用wp_deregister_script('jquery')函数并将其挂载到wp_enqueue_scripts动作钩子，您可以有效地从WordPress网站中移除由Google CDN加载的jQuery脚本。这有助于解决重复加载、性能瓶颈和版本冲突等问题。如果您需要替换为自定义的jQuery版本，请务必在注销后使用wp_enqueue_script()函数注册并加载您的新版本，并始终遵循最佳实践，确保网站的稳定性和兼容性。
