欢迎使用 Node.js 官方 API 参考文档

Node.js 是基于 Chrome V8 引擎构建的 JavaScript 运行时环境，其官方 API 参考文档提供了全面的接口说明和用法指南。

报告错误与贡献

如果您在文档中发现错误，可以在项目的问题跟踪系统中提交报告。如果您希望直接贡献修改，请查阅相关说明了解如何提交拉取请求（Pull Request）。

稳定性指标

Node.js API 文档中对每个功能的稳定性进行了分类标记，帮助开发者评估是否适合在生产环境中使用。

0 - 弃用（Deprecated）

标记为 0 的功能可能会触发警告，且不保证向后兼容性。这些功能可能会在未来版本中被移除。

1 - 实验性（Experimental）

实验性功能可能随时发生非向后兼容的更改或删除，不建议在生产环境中使用。实验性功能分为几个阶段：

早期开发（1.0）：功能仍在开发中，可能频繁变化。

活跃开发（1.1）：功能已基本成型，但仍可能调整。

发布候选（1.2）：功能接近稳定，但仍需验证。

2 - 稳定（Stable）

稳定 API 与 npm 生态系统高度兼容，遵循语义化版本控制（SemVer），不会轻易被移除或破坏性变更。

3 - 旧版（Legacy）

旧版功能不再积极维护，但仍受语义版本控制保护。如果某个功能在 npm 生态系统中被广泛依赖，且没有明显危害，可能会被标记为旧版而非弃用。旧版功能中的缺陷通常不会被修复。

使用实验性功能的注意事项

实验性功能可能存在行为变化或兼容性问题，特别是在库开发中，用户可能不了解这些功能的实验性质。为避免意外情况，某些实验性功能可能需要通过命令行标志启用。

文档格式与辅助工具

每个 HTML 格式的 API 文档都有对应的 JSON 文件，方便 IDE 和其他工具解析和使用。

系统调用与手册页

Node.js 提供的函数如果封装了底层系统调用（如文件操作、网络请求等），文档会描述其行为并链接到对应的系统手册页（man page）。尽管 Node.js 尽量与 Unix 系统调用保持一致，但由于平台差异，某些行为可能有所不同。