获取 jQuery 文件
在开始之前,你需要先获取 jQuery 文件,主要有两个版本:

(图片来源网络,侵删)
- 生产版 (Production): 文件名通常以
.min.js如jquery-3.7.1.min.js),这个版本经过了代码压缩和混淆,去除了所有不必要的空格和注释,文件体积小,加载速度快,强烈推荐在网站正式上线时使用。 - 开发版 (Development): 文件名不以
.min.js如jquery-3.7.1.js),这个版本是未压缩的,代码格式清晰,方便阅读和调试。仅在开发调试阶段使用。
你可以从以下官方渠道下载:
- jQuery 官方网站: https://jquery.com/download/
- Google Hosted Libraries: https://developers.google.com/speed/libraries
- CDN (内容分发网络): 直接使用 CDN 链接,无需下载文件。
直接上传到网站目录(最常用、最推荐)
这是最直接、最可控的方法,尤其适合不熟悉服务器配置的用户。
操作步骤:
-
下载 jQuery 文件:从上述渠道下载
jquery-x.x.x.min.js文件。 -
上传到服务器:
(图片来源网络,侵删)- 使用 FTP 工具(如 FileZilla)登录你的网站服务器。
- 找到织梦模板的根目录,通常是
/templets/。 - 在
/templets/目录下新建一个文件夹,例如命名为js。 - 将下载好的
jquery-x.x.x.min.js文件上传到这个新创建的/templets/js/目录中。
你的文件路径现在看起来像这样:
/templets/js/jquery-x.x.x.min.js -
在模板中引入 jQuery:
- 登录织梦后台,进入【模板】->【模板管理】。
- 找到你当前正在使用的模板,点击【默认】或【修改】。
- 在模板代码中,找到
</head>标签。最佳实践是将所有 JavaScript 文件放在</head>标签之前,这样可以确保页面内容加载前脚本就已准备好。 - 在
<head>和</head>之间添加以下代码:
<script type="text/javascript" src="/templets/js/jquery-x.x.x.min.js"></script>
- 将
jquery-x.x.x.min.js替换成你实际上传的文件名。 - 点击【保存】。
优点:
- 完全可控:jQuery 文件托管在自己服务器上,不依赖第三方服务。
- 加载稳定:不受外部 CDN 服务的影响。
- SEO 友好:对于国内搜索引擎,本地资源加载速度通常更快、更稳定。
缺点:
- 需要自己手动管理和上传文件。
使用 CDN(最快捷、最流行)
这种方法不需要下载和上传任何文件,直接通过链接引入 jQuery,是现代网站开发的主流方式。
操作步骤:
-
选择一个 CDN 服务商:
(图片来源网络,侵删)- 国内推荐:使用百度、新浪、BootCDN 等,因为它们的服务器在国内,访问速度快。
- BootCDN: https://www.bootcdn.cn/jquery/
- 新浪 CDN:
https://lib.sinaapp.com/js/jquery/jquery-x.x.x.min.js
- 国际通用:Google, Microsoft, jQuery 官方 CDN。
- jQuery 官方 CDN:
https://code.jquery.com/jquery-x.x.x.min.js
- jQuery 官方 CDN:
- 国内推荐:使用百度、新浪、BootCDN 等,因为它们的服务器在国内,访问速度快。
-
在模板中引入 jQuery:
- 同样地,进入【模板】->【模板管理】,修改你的模板文件。
- 在
<head>标签内添加以下代码(这里以 BootCDN 为例):
<!-- 引入 jQuery 3.7.1 版本 --> <script src="https://cdn.bootcdn.net/ajax/libs/jquery/3.7.1/jquery.min.js"></script>
- 你可以从 CDN 网站上直接复制最新的链接。
- 点击【保存】。
优点:
- 加载速度快:CDN 节点遍布全球,用户访问时从最近的节点获取文件,速度快。
- 减轻服务器负担:jQuery 文件由 CDN 服务器提供,不占用你的服务器带宽。
- 利用浏览器缓存:如果其他网站也使用了同一个 CDN,用户的浏览器可能已经缓存了 jQuery 文件,再次加载时速度极快。
缺点:
- 依赖第三方:CDN 服务器出现故障或被屏蔽,你的网站将无法加载 jQuery,导致相关功能失效。
- 潜在的安全风险:虽然大型 CDN 服务商很可靠,但理论上存在被篡改的风险(概率极低)。
利用织梦自身机制(DedeCMS V5.7+)
织梦从 V5.7 版本开始,内置了一个简单的 JS 文件管理功能,可以方便地向模板中添加系统自带的或你上传的 JS 文件。
操作步骤:
-
上传 jQuery 文件:
- 同方法一,将
jquery-x.x.x.min.js上传到服务器的/templets/js/目录。
- 同方法一,将
-
在后台添加 JS 文件:
- 登录织梦后台,进入【系统】->【系统基本参数】。
- 在左侧菜单选择【核心设置】。
- 找到
cfg_arc_click_js这个选项(它的作用是定义文章内容页的 JS 文件)。 - 在输入框中填入你的 jQuery 文件路径,
/templets/js/jquery-x.x.x.min.js。 - 点击【保存】。
注意:这种方法通常只对文章内容页(
article_article.htm)有效,如果你希望它在首页、列表页等所有页面都生效,你需要修改所有模板文件,在每个模板的<head>部分手动加入<script>标签,指向这个 JS 文件。此方法不如前两种方法通用。
优点:
- 后台管理,看似方便。
缺点:
- 不灵活:作用范围有限,通常只针对文章页。
- 不够直观:不如直接在模板里写
<script>标签清晰明了。 - 不推荐:除非你有特殊需求,否则优先选择方法一或方法二。
最佳实践和注意事项
- 版本选择:尽量使用较新的稳定版本(如 3.x 系列),但不要使用最新的测试版,以确保兼容性和稳定性。
- 放置位置:将 jQuery 的
<script>标签放在<head>标签内,并放在其他依赖 jQuery 的插件(如jquery-ui.js,bootstrap.js)之前。 - 避免重复加载:确保你的整个网站只加载一次 jQuery,如果多个模板都引入了,或者模板和织梦系统本身都引入了,就会造成重复加载,浪费资源并可能引发冲突。
- 使用 符号冲突:如果你的模板中还使用了其他 JavaScript 库(如 Prototype, MooTools),它们也使用 符号,就会与 jQuery 冲突,这时可以使用 jQuery 的
noConflict模式来解决,在引入 jQuery 后添加:<script> var $j = jQuery.noConflict(); // 之后使用 $j 代替 $ 来调用 jQuery 函数 $j(document).ready(function() { $j("button").click(function(){ $j("p").slideToggle(); }); }); </script>
| 方法 | 优点 | 缺点 | 推荐度 |
|---|---|---|---|
| 本地上传 | 完全可控,稳定,SEO友好 | 需手动管理 | ★★★★★ (最推荐) |
| 使用 CDN | 速度快,减轻服务器负担 | 依赖第三方,有潜在风险 | ★★★★☆ (非常流行) |
| 织梦自带 | 后台管理 | 不灵活,作用范围有限 | ★☆☆☆☆ (不推荐) |
对于绝大多数用户来说,强烈推荐使用方法一(本地上传),因为它兼顾了稳定性和可控性,如果你对加载速度有极致追求且不介意依赖第三方,方法二(使用 CDN) 是一个绝佳的选择。
