Skip to content
zhcndocPublic

About

Node.js 中文文档

Resources

Stars

2 stars

Watchers

0 watching

Forks

Repository files navigation

Node.js

Node.js 是一个开源、跨平台的 JavaScript 运行时环境。

有关 Node.js 的使用信息,请参阅 Node.js 网站。

Node.js 项目采用开放治理模式。OpenJS Foundation 为该项目提供支持。

我们期望贡献者以协作的方式推动项目发展。我们鼓励建设性地交流不同意见并达成妥协。TSC 保留限制或阻止那些屡次以打击、耗尽或以其他方式对其他参与者造成负面影响的方式行事的贡献者的权利。

本项目有一份行为准则。

目录

支持

需要帮助?请查看获取支持的说明。

发布类型

  • Current:正在积极开发。Current 版本的代码位于对应主版本号的分支中(例如,v22.x)。Node.js 每 6 个月发布一个新的主版本,允许引入破坏性变更。发布时间为每年的 4 月和 10 月。每年 10 月发布的版本支持期限为 8 个月。每年 4 月发布的版本会在当年 10 月转为 LTS(见下文)。
  • LTS:获得长期支持的版本,重点关注稳定性和安全性。每个偶数主版本都会成为 LTS 版本。LTS 版本会获得 12 个月的 Active LTS 支持,随后还有 18 个月的 Maintenance 支持。LTS 版本系列的代号按字母顺序排列,从 v4 Argon 开始。除某些特殊情况外,不会有破坏性变更或新增功能。
  • Nightly:当有变更时,每 24 小时基于 Current 分支构建的代码。请谨慎使用。

Current 和 LTS 版本遵循语义化版本规范。发布团队的一名成员会对每个 Current 和 LTS 版本进行签名。有关更多信息,请参阅发布 README。

下载

可在 https://nodejs.org/en/download/ 获取二进制文件、安装程序和源代码 tarball。

Current 和 LTS 版本

https://nodejs.org/download/release/

latest 目录是指向最新 Current 版本的别名。latest-codename 目录是指向 LTS 系列最新版本的别名。例如,latest-hydrogen 目录包含最新的 Hydrogen(Node.js 18)版本。

Nightly 版本

https://nodejs.org/download/nightly/

每个目录和文件名都包含版本号(例如,v22.0.0),后接 UTC 日期(例如,2024 年 4 月 24 日对应 20240424),以及该版本 HEAD 的短提交 SHA(例如,ddd0a9e494)。例如,完整的目录名可能是 v22.0.0-nightly20240424ddd0a9e494。

API 文档

最新 Current 版本的文档位于 https://nodejs.org/api/。特定版本的文档可在每个发布目录的 docs 子目录中找到。特定版本的文档也可在 https://nodejs.org/download/docs/ 获取。

验证二进制文件

下载目录包含一个 SHASUMS256.txt.asc 文件,其中包含文件的 SHA 校验和以及发布者的 PGP 签名。

你可以从 nodejs/release-keys 获取受信任的密钥环,例如使用 curl:

curl -fsLo "/path/to/nodejs-keyring.kbx" "https://github.com/nodejs/release-keys/raw/HEAD/gpg/pubring.kbx"

或者,你可以将发布者密钥导入默认密钥环。如何执行此操作的命令,请参阅发布密钥。

然后,你可以验证已下载到本地的文件(如果使用默认密钥环,请传入 --keyring="${GNUPGHOME:-~/.gnupg}/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

有关如何从源代码构建 Node.js 的说明以及支持的平台列表,请参阅 BUILDING.md。

安全

有关如何报告 Node.js 安全漏洞的信息,请参阅 SECURITY.md。

为 Node.js 做贡献

当前项目团队成员

有关 Node.js 项目治理的信息,请参阅 GOVERNANCE.md。

TSC(技术指导委员会)

TSC 投票成员

TSC 常规成员

TSC 荣誉成员

TSC 荣誉成员

协作者

荣誉退休协作者

荣誉退休协作者

协作者在维护 Node.js 项目时遵循协作者指南。

分诊者

分类人员在回复新问题时遵循分类指南。

发布密钥

Node.js 发布人员的主要 GPG 密钥(部分发布人员使用子密钥签名):

你可以使用项目维护的密钥环,地址为 https://github.com/nodejs/release-keys/raw/refs/heads/main/gpg-only-active-keys/pubring.kbx。 或者,你也可以从公共密钥服务器导入这些密钥。请注意,项目无法保证服务器或该服务器上的密钥始终可用。

gpg --keyserver hkps://keys.openpgp.org --recv-keys 5BE8A3F6C8A5C01D106C0AD820B1A390B168D356 # Antoine du Hamel
gpg --keyserver hkps://keys.openpgp.org --recv-keys DD792F5973C6DE52C432CBDAC77ABFA00DDBF2B7 # Juan José Arboleda
gpg --keyserver hkps://keys.openpgp.org --recv-keys CC68F5A3106FF448322E48ED27F5E38D5B0A215F # Marco Ippolito
gpg --keyserver hkps://keys.openpgp.org --recv-keys 890C08DB8579162FEE0DF9DB8BEAB4DFCF555EF4 # Rafael Gonzaga
gpg --keyserver hkps://keys.openpgp.org --recv-keys C82FA3AE1CBEDC6BE46B9360C43CEC45C17AB93C # Richard Lau
gpg --keyserver hkps://keys.openpgp.org --recv-keys 108F52B48DB57BB0CC439B2997B01419BD92F80A # Ruy Adorno
gpg --keyserver hkps://keys.openpgp.org --recv-keys 655F3B5C1FB3FA8D1A0CA6BDE4A7D232B936D2FD # Stewart X Addison
gpg --keyserver hkps://keys.openpgp.org --recv-keys A363A499291CBBC940DD62E41F10027AF002F8B0 # Ulises Gascón

请参阅验证二进制文件,了解如何使用这些密钥验证下载的文件。

用于签署某些早期版本的其他密钥

项目维护了一个密钥环,可用于验证 Node.js 的所有过往版本,地址为 https://github.com/nodejs/release-keys/raw/refs/heads/main/gpg/pubring.kbx。

安全发布负责人

在可能的情况下,由公司承诺参与安全发布负责人轮值,以确保担任安全负责人的个人能够获得雇主的支持和认可,从而优先处理安全发布。安全发布负责人按照安全发布流程中所述的方式轮值管理安全发布。

许可证

Node.js 根据 MIT 许可证授权。

本项目还依赖可能采用不同开源许可证的外部库。有关所含许可证的完整列表,请参阅 LICENSE 文件。

如果你要贡献文档或源代码更改,请确保你的新增内容符合项目的许可证指南。

About

Node.js 中文文档

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages