最稳妥的方式是直接用<script>标签引入CDN链接,推荐jsDelivr的jQuery 3.7.1版本;若需兼容IE8–9则改用1.12.4;注意路径、版本、执行时序和全局变量污染问题。

直接用 <script> 标签引入 CDN 链接最稳妥
绝大多数情况下,不需要下载 jQuery 文件本地存放。CDN 加载快、缓存率高、还能跨站复用。推荐使用官方推荐的 CDN(如 cdnjs 或 jsDelivr),避免用已停更的旧地址。
在 index.html 的 <head> 底部或 <body> 最底部插入:
<script src="https://cdn.jsdelivr.net/npm/jquery@3.7.1/dist/jquery.min.js"></script>
注意:3.7.1 是当前较新的稳定版,若项目需兼容 IE8–9,得换用 1.12.4;但新版 jQuery(3.x)已不支持 IE$ is not defined。
- 别把
<script>放在 jQuery 使用代码之前,否则执行时$还没定义 - 如果用了模块打包工具(如 Webpack/Vite),不应再手动加
<script>,而应npm install jquery后import $ from 'jquery' - 某些 CDN 地址末尾带
?no-check或&ver=xxx是冗余参数,可删掉,不影响加载
本地引入时路径写错是 $ is not defined 的主因
如果非要放本地,把 jquery.min.js 放进 js/ 目录后,引用路径必须和实际文件位置严格匹配。浏览器控制台报 404 或 net::ERR_ABORTED 就说明路径错了。
立即学习“前端免费学习笔记(深入)”;
常见错误写法:
<script src="jquery.min.js"></script> <!-- 假设文件其实在 ./js/jquery.min.js -->
正确写法(假设目录结构为 index.html 和 js/jquery.min.js 同级):
<script src="js/jquery.min.js"></script>
- 路径区分大小写,
JQuery.min.js≠jquery.min.js - 用相对路径时,起点是
index.html所在目录,不是当前 JS 文件所在目录 - 开发服务器(如 Live Server)下,
file://协议可能禁用跨域请求,导致本地引入失败;务必用http://服务访问
验证 jQuery 是否加载成功:别只看控制台有没有报错
即使没报错,也可能加载了错误版本或被其他库覆盖。最直接的验证方式是在浏览器控制台输入:
typeof $
返回 "function" 才算真正可用。如果返回 "undefined",说明没加载;返回 "object" 可能是其他库占用了 $(比如 Prototype.js)。
- jQuery 3.x 默认不自动恢复
window.$给非 AMD 环境,但 CDN 版本仍会挂载,不用额外处理 - 若页面同时用 Vue/React,它们一般不冲突;但用了
jQuery.noConflict()后,$就失效了,得改用jQuery(...) - 检查 Network 面板里
jquery.min.js的 Status 是否为200,Size 是否 > 0,避免空文件或重定向失败
jQuery 的引用看似简单,但路径、版本、执行时序、全局变量污染这四点,任一出错都会让后续所有 $(...) 调用静默失败。调试时优先看 Network 和 console,而不是反复改 HTML 结构。


















