嵌入全站共享导航的jQuery脚本报$未定义 本地正常但服务器失效
报错根因
$ is Not Defined 本质是浏览器执行你的导航加载脚本时,没有加载jQuery库——你用的$.get、$.load都是jQuery提供的方法,只有先加载jQuery,$符号才会被识别。
你之前在Atom的Browser-Plus里能正常运行,是因为这个IDE插件内置了jQuery加载环境,直接双击打开本地HTML、或者上传到线上服务器时,没有这个内置依赖,就会触发报错。
另外你之前遇到的本地直接打开时导航加载失败的问题,是浏览器默认的跨域安全限制:直接用file://协议打开的本地文件,不允许通过ajax/fetch请求加载同目录下的其他HTML文件,和代码兼容问题无关。
可落地的解决方案
方案1:修复现有jQuery实现(改动最小)
- 把jQuery核心文件保存到你网站的项目本地目录(和HTML页面、nav.html同文件夹即可,避免路径写错)
- 在你写的两段导航加载脚本之前,加入jQuery的引入代码:
<script src="jquery.min.js"></script>
注意:必须把这行放在导航脚本前面,浏览器是按顺序加载脚本的,顺序错了还是会报$未定义的错。 - 保留你之前写的任意一段导航加载脚本即可,两段功能完全一致。
方案2:无jQuery依赖的替代实现(长期维护更省心)
不用引入任何外部库,从根源上避免$未定义的报错,代码更少、加载更快:
- 页面中还是保留之前的导航占位符:
<div id="nav-placeholder"></div> - 把之前的jQuery脚本全部替换成下面这段原生JS代码:
<script> fetch("nav.html") .then(res => res.text()) .then(navContent => { document.getElementById("nav-placeholder").innerHTML = navContent; }); </script>
解决本地验证难题(满足上线审核要求)
你之前本地直接双击打开HTML无法加载导航,是因为file://协议下的跨域限制,只要用本地静态服务的方式启动项目,就能和线上运行效果完全一致:
- 用你已经在用的Atom编辑器,安装本地静态服务类插件,启动后浏览器地址栏会显示
http://localhost:端口号开头的地址,此时所有代码的运行逻辑和线上服务器完全相同,不会再出现跨域拦截、依赖未加载的问题。 - 验证通过的标准:页面导航正常显示,浏览器控制台没有红色报错,就可以打包给IT经理上传服务器,完全符合你负责人“本地跑通再上线”的要求。
上线前必查项
- 检查所有文件的相对路径是否正确:比如如果HTML页面在网站二级目录下,就要把脚本里的文件路径改成对应层级的相对地址,避免浏览器找不到jquery文件、nav.html文件。
- 确认nav.html里的导航样式、链接地址都已调整为正式上线的路径。
内容的提问来源于stack exchange,提问作者cmorrison18
相关产品推荐
相关产品推荐

