jquery/jquery

# [jQuery](https://jquery.com/) — 新浪潮 JavaScript 会议目前在 [matrix.org 平台](https://matrix.to/#/#jquery_meeting:gitter.im) 上举行。 会议记录可在 [meetings.jquery.org](https://meetings.jquery.org/category/core/) 找到。 jQuery 的最新版本可在 [https://jquery.com/download/](https://jquery.com/download/) 获取。 ## 版本支持 | Version | Branch | Status | | ------- | ---------- | -------- | | 4.x | main | Beta | | 3.x | 3.x-stable | Active | | 2.x | 2.x-stable | Inactive | | 1.x | 1.x-stable | Inactive | [jQuery 4.0.0 已经发布！](https://blog.jquery.com/2026/01/17/jquery-4-0-0/) 3.x 分支现在将仅接收关键更新。2.x 和 1.x 分支不再受支持。 [HeroDevs](https://herodevs.com/support/jquery-nes) 为非活跃版本提供商业支持。 了解更多关于我们的[版本支持](https://jquery.com/support/)的信息。 ## 贡献指南 本着开源软件开发的精神，jQuery 始终鼓励社区贡献代码。为了帮助您入门，在开始编写代码之前，请务必仔细阅读这些重要的贡献指南： 1. [参与其中](https://contribute.jquery.org/) 2. [核心风格指南](https://contribute.jquery.org/style-guide/js/) 3. [为 jQuery 项目编写代码](https://contribute.jquery.org/code/) ### 问题/PR 引用 GitHub issues/PRs 通常通过 `gh-NUMBER` 引用，其中 `NUMBER` 是 issue/PR 的数字 ID。您可以在 `https://github.com/jquery/jquery/issues/NUMBER` 下找到此类 issue/PR。 jQuery 过去曾使用不同的 Bug 跟踪器 —— 基于 Trac —— 可在 [bugs.jquery.com](https://bugs.jquery.com/) 访问。它目前保持只读模式，以便参考过去的讨论。当 jQuery 源代码引用其中一个问题时，它使用模式 `trac-NUMBER`，其中 `NUMBER` 是问题的数字 ID。您可以在 `https://bugs.jquery.com/ticket/NUMBER` 下找到此类问题。 ## 使用 jQuery 的环境 - [浏览器支持](https://jquery.com/browser-support/) - jQuery 还支持 Node、浏览器扩展和其他非浏览器环境。 ## 构建您自己的 jQuery 所需的内容 要构建 jQuery，您需要拥有最新的 Node.js/npm 和 git 1.7 或更高版本。早期版本可能有效，但不受支持。 对于 Windows，您必须下载并安装 [git](https://git-scm.com/downloads) 和 [Node.js](https://nodejs.org/en/download/)。 macOS 用户应该安装 [Homebrew](https://brew.sh/)。安装 Homebrew 后，运行 `brew install git` 来安装 git， 并运行 `brew install node` 来安装 Node.js。 Linux/BSD 用户应该使用其合适的包管理器来安装 git 和 Node.js，或者如果您喜欢那种方式，可以从源代码构建。 简单明了。 ## 如何构建您自己的 jQuery 首先，[克隆 jQuery git 仓库](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/cloning-a-repository)。 然后，进入 jquery 目录，安装依赖项，并运行构建脚本： ``` cd jquery npm install npm run build ``` 构建好的 jQuery 版本将被放置在 `dist/` 目录中，其中还包括一个压缩副本和关联的 map 文件。 ## 构建所有 jQuery 发布文件 要构建 jQuery 的所有变体，请运行以下命令： ``` npm run build:all ``` 这将创建 jQuery 在发布中包含的所有变体，包括 `jquery.js`、`jquery.slim.js`、`jquery.module.js` 和 `jquery.slim.module.js`，以及它们关联的压缩文件和 sourcemaps。 `jquery.module.js` 和 `jquery.slim.module.js` 是 [ECMAScript modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules)，它们将 `jQuery` 和 `$` 作为命名导出，并放置在 `dist-module/` 目录而不是 `dist/` 目录中。 ## 构建自定义 jQuery 构建脚本可用于创建仅包含所需模块的自定义 jQuery 版本。 除了 `core` 之外，任何模块都可以被排除。当排除 `selector` 时，它并没有被移除，而是被一个围绕原生 `querySelectorAll` 的小包装器替换（有关更多信息，请参见下文）。 ### 构建脚本帮助 要查看构建脚本的可用选项完整列表，请运行以下命令： ``` npm run build -- --help ``` ### 模块 要排除模块，请将其相对于 `src` 文件夹的路径（不带 `.js` 扩展名）传递给 `--exclude` 选项。使用 `--include` 选项时，默认包含项将被删除，并仅使用这些模块创建构建。 一些可以排除或包含的示例模块有： - **ajax**：所有 AJAX 功能：`$.ajax()`、`$.get()`、`$.post()`、`$.ajaxSetup()`、`.load()`、transports 以及 ajax 事件简写（如 `.ajaxStart()`）。 - **ajax/xhr**：仅 XMLHTTPRequest AJAX transport。 - **ajax/script**：仅 `