如何修复”jQuery is Not Defined”错误

作者 : King 本文共1960个字,预计阅读时间需要5分钟 发布时间: 2025-05-11 共8人阅读
错误类型:
浏览器错误
错误名称:
JQuery未定义
英文名称:
jQuery is Not Defined
错误描述:
简单地说,这个错误试图告诉您站点上的某些东西(可能是插件)需要jQuery在您的站点上运行。出于某种原因,当浏览器尝试加载网站并调用特定jQuery时,它不可用。

如何修复

无论你对WordPress错误是否陌生,在你的网站上工作时遇到“jQuery is not defined”从来都不是一件有趣的事。这可能是一个令人震惊和困惑的信息。幸运的是,这是使用jQuery的站点在某些时候可能遇到的标准错误。

也许您的站点已关闭,当您检查浏览器控制台是否有错误时,您会看到“jQuery is not defined”。查找错误是第一步,做得很好!

下一步是解决它。因为这是一个更容易修复的JavaScript错误,所以不需要花费很长时间。

在这篇文章中,我们将带您了解快速修复它所需的所有知识。这包括错误的含义,它可能首先发生的原因-所有防止将来发生此错误的关键信息。最后,我们将引导您完成解决此问题的几个步骤。

  1. 什么是”jQuery is not defined”错误?
  2. 如何修复”jQuery is not defined”错误

什么是”jQuery is not defined”错误?

浏览器中方便的控制台日志中,您可能会发现此错误。但这并不是令人难以置信的描述。“jQuery is not defined”实际上是什么意思?

简单地说,这个错误试图告诉您站点上的某些东西(可能是插件)需要jQuery在您的站点上运行。出于某种原因,当浏览器尝试加载网站并调用特定jQuery时,它不可用。

此错误可能会导致网站对访问者关闭。因为互联网上大约78%的网站运行jQuery,这是一个常见的错误。

控制台日志中“jQuery is not defined

控制台日志中“jQuery is not defined” 错误

“jQuery is not defined”错误的潜在原因

这个错误可能会让人大吃一惊。你的网站昨天运行得很好-发生了什么事?这可能有点让人头痛。

可能发生了一些可能引发“jQuery未定义”错误的情况:

  1. WordPress站点上安装的旧插件与您最近安装并激活的插件冲突。如果知识兔您最近安装或激活了新插件,或者您站点上的某些插件最近没有更新,这可能是原因。
  2. 性能缓慢或较差的托管环境可能会增加调用jQuery时执行jQuery所需的时间。仔细检查服务器资源或错误日志以确认这一点。
  3. 在jQuery完全加载之前,网站上的JavaScript正在运行。或者页面加载时JavaScript文件没有正确加载。
  4. 用于提高站点性能的CDN无法访问服务器。如果知识兔您根本没有使用CDN,那么可以完全排除这种可能性。
  5. 您的jQuery版本中存在错误或输入错误。也许有人最近编辑了一个核心文件或插件,这导致了冲突。

如何修复”jQuery is not defined”错误

在我们开始修复之前,请记住在编辑代码之前备份您的网站!即使知识兔是经验最丰富的开发人员也会时不时地犯错误,手头有备份可以防止您在故障排除时丢失任何重要的工作。

一旦你采取了这些必要的预防措施,是时候纠正这个错误了。

解决此错误需要熟悉添加、删除和编辑代码。别担心,您不需要从头开始编写任何代码。但如果知识兔您准备通过SFTP或托管环境访问站点的代码,这将有所帮助。

它不适合通过WordPress仪表板代码编辑器编辑代码。如果知识兔你手头还没有一个好的文本编辑器,现在是时候安装一个了。

这里有几个选项可以用来解决此错误,并将您的站点恢复给访问者。

方法 1: 如果知识兔jquery正在加载,请使用网络选项卡进行调试

查看浏览器开发工具的“网络”选项卡,查看是否正在加载jQuery。这为您分享了一个快速验证的地方。

另一种选择是查看可能导致错误的多个插件和主题。检查站点的代码,确保包含jQuery。最好只加载一次。

如果知识兔未包含jQuery库,请使用以下代码段将其添加到wp_enqueue_script()函数中:

wp_enqueue_script( 'tt-mobile-menu', get_template_directory_uri() .'/js/mobile-menu.js', array('jQuery'), '1.0', true );

通过转到wp_includes文件夹找到此代码,然后知识兔打开script-loader.php文件。如果知识兔这不起作用,或者如果知识兔您发现jQuery库实际上已经包含在内,请转到以下方法。

代码段在script-loader.php文件中的外观

代码段在script-loader.php文件中的外观

方法 2: 确保jquery已加载

当包含但未加载jQuery时,您可能会遇到“jQuery is not defined error”。通过查找脚本源并将URL粘贴到新浏览器或选项卡中,确保已加载该脚本。

例如,如果知识兔