Node.js

Node.js 项目概述

Node.js 是一款开源、跨平台的 JavaScript 运行时环境。项目采用开放式治理模型，由 OpenJS 基金会提供支持，并要求所有贡献者遵循协作准则和行为守则。

支持与反馈

如需获取帮助，请参阅 .github/SUPPORT.md 中关于如何寻求支持的说明。

发布版本类型

Node.js 提供三类发布渠道：

Current（当前版本）

处于活跃开发状态。代码位于对应主版本号的分支（例如 v22.x）。Node.js 每 6 个月发布一个新的主版本，允许包含破坏性变更，分别在每年 4 月与 10 月发布。10 月发布的版本支持周期为 8 个月，4 月发布的版本在当年 10 月转为 LTS。

LTS（长期支持版本）

聚焦稳定性与安全。所有偶数号主版本都会成为 LTS。LTS 版本享有 12 个月的"活跃 LTS"支持期，以及后续 18 个月的"维护期"。LTS 版本代号按字母顺序排列，从 v4 Argon 开始。除特殊情况外，不引入破坏性变更或新功能。

Nightly（每夜构建版）

由 Current 分支每 24 小时自动构建（仅在有变更时），请谨慎使用。

Current 与 LTS 版本均遵循语义化版本控制（Semantic Versioning）。每个版本均由 Release 团队成员签名发布。

下载与验证

下载地址

• 二进制包、安装包与源码归档：https://nodejs.org/en/download/
• Current 与 LTS：https://nodejs.org/download/release/
• latest 目录指向最新 Current 版本
• latest-<代号> 目录指向对应 LTS 线的最新版本（如 latest-hydrogen）
• Nightly：https://nodejs.org/download/nightly/

Nightly 目录命名格式示例：v22.0.0-nightly20240424ddd0a9e494，依次为版本号、UTC 日期、HEAD 提交短 SHA。

API 文档

最新 Current 版本文档位于 https://nodejs.org/api/；特定版本的文档可在各发布目录的 docs 子目录下找到。

验证二进制包

每个下载目录包含 SHASUMS256.txt.asc 文件，记录 SHA 校验值与发布者的 PGP 签名。

下载受信公钥环：

# 下载 Node.js 发布密钥环
curl -fsLo "/path/to/nodejs-keyring.kbx" "https://github.com/nodejs/release-keys/raw/HEAD/gpg/pubring.kbx"

验证本地下载文件：

# 拉取校验文件并校验完整性
curl -fsO "https://nodejs.org/dist/${VERSION}/SHASUMS256.txt.asc" \
&& gpgv --keyring="/path/to/nodejs-keyring.kbx" --output SHASUMS256.txt < SHASUMS256.txt.asc \
&& shasum --check SHASUMS256.txt --ignore-missing

源码构建

从源码构建 Node.js 的详细步骤及支持平台列表，请参阅 BUILDING.md。

安全

报告安全漏洞的方式见 SECURITY.md。

贡献与项目团队

贡献指南、工作组、战略计划以及技术价值观相关内容，请参阅 GOVERNANCE.md 及对应贡献文档。