📌 项目地址:jquery/jquery | ⭐ 59,987 颗星 | 🔧 JavaScript
先说结论
如果你的项目还在跑 jQuery 1.x 或 2.x,官方已经不再修任何漏洞了。3.x 只收关键性修复,新功能不会有。这两个事实写在 jquery/jquery 的 README 里,白纸黑字。
jQuery 4.0.0 已于 2026 年 1 月 17 日正式发布,4.x 分支(main)是目前唯一获得完整支持的版本。官方的态度很直白:要么升级,要么买商业支持(HeroDevs 和 TuxCare 两家提供),要么自己扛安全风险。
版本支持一览
| 版本 | 分支 | 支持状态 |
|---|---|---|
| 4.x | main | 完整支持 |
| 3.x | 3.x-stable | 仅关键修复 |
| 2.x | 2.x-stable | 无支持 |
| 1.x | 1.x-stable | 无支持 |
4.0 意味着什么
很多人对 jQuery 的印象还停留在“浏览器兼容时代的产物”,这个印象该更新了。4.0 是一次大版本迭代,官方明确建议所有用户升级,理由是性能、安全和功能上的改进。README 没有展开具体改进点,想了解细节可以去官方博客的 4.0 发布公告看。
实际场景上我的判断是这样:新建 SPA 项目,React、Vue 这些框架依然是主流选择,jQuery 不是第一选项。但传统多页面网站、内容型站点、需要在老代码上渐进增强的场景,jQuery 依然能用,4.0 之后用起来也更放心。
运行环境
jQuery 不只跑在浏览器里。README 明确说它支持 Node、浏览器扩展和其他非浏览器环境。浏览器支持范围见官方页面 https://jquery.com/browser-support/。
想自己构建?要求不高
构建 jQuery 需要两样东西:最新版 Node.js/npm,以及 git 1.7 或更高版本。更早的 git 版本也许能跑,但官方不支持。
- Windows:分别下载安装 git 和 Node.js
- macOS:先装 Homebrew,再执行
brew install git
具体构建命令 README 里没写,官方贡献文档(https://contribute.jquery.org/)里有完整流程。
一个有意思的历史细节
读 jQuery 源码时你会遇到两套 issue 编号,这是历史遗留。gh-NUMBER 指 GitHub 上的 issue 或 PR,地址是 https://github.com/jquery/jquery/issues/NUMBER。而 trac-NUMBER 指旧时代用的 Trac 跟踪系统(bugs.jquery.com),该系统现在只读保留,地址是 https://bugs.jquery.com/ticket/NUMBER。
追溯十几年前的老问题时,得先分清编号属于哪套系统,否则查不到。
想贡献代码
jQuery 欢迎社区贡献,但动手前官方要求先读三份文档:
- Getting Involved(https://contribute.jquery.org/)
- Core Style Guide(https://contribute.jquery.org/style-guide/js/)
- Writing Code for jQuery Projects(https://contribute.jquery.org/code/)
我觉得这几份文档本身就值得读,不只是为了贡献代码。Core Style Guide 是一份成熟的 JavaScript 代码规范,jQuery 团队维护了十几年,比很多后来出现的规范文档更经得起推敲。
开发节奏
项目会议在 matrix.org 平台上进行,会议记录公开在 https://meetings.jquery.org/category/core/。想了解 jQuery 团队在做什么、4.x 接下来的方向,看会议记录比看代码提交记录更省事。