Node.js说明

关于

编写本文档的目的是为了读者能够更好的理解和查阅Node.js 的API。文档将介绍内置模块的一些功能和一些高级概念，读者需要耐心阅读。

Node.js稳定性说明

Node.js作为一个仍在发展中的技术，它的API集合也是一直在发展变化的。这种“变化”有如下含义：

1.      API集合的变化是持续性的，它具有过去式、现在式和将来式。即一部分历史的API已经过时，一部分是我们现在可用的，还有一部分会在未来出现（现在没有的事物，谁能保证以后没有呢？）

2.     API集合是动态的。比如有一些API现在已经很成熟、可靠，在未来的一段时间内不会发生改变，而有一些分支则有待进一步完善。这部分API在未来的一段时间内是动态的、持续更新和有待重新设计的。

根据上述原则，我们把API稳定指数分为6类。按照从0开始，依次如下：

0：已过时-Deprecated

这类API是不推荐使用的。由于这部分API功能上可能存在一些问题，在未来肯定会发生变化，所以对编程者而言它的可依赖性不强，向后兼容性也存在疑问。使用该功能的时候，会导致警告（可能是warning提醒）

1：实验阶段-Experimental

这类API功能在近期才被引入进来，还没有经受互联网开发者的“筛选”，在未来版本中可能被修改、完善或者删除。根据互联网技术“先使用后完善”的特点，我们可以尝试使用这些API，出现了问题及时反馈，总会有高人进行解决。另外，如果发现这部分的API对开发者特别有用，我们应当及时反馈，让相关人士认识到这部分API的重要性，以期将来将这部分API固化、完善。

2：不稳定版本-Unstable

这部分API经受住了试验阶段考验，被证明是有用的、应当被保留下来的，但是还没有经过足够的测试、检验，它们的稳定性尚存在疑问。如果实际需要，在将来版本中将被维护、完善和强化。

3：稳定版-Stable

这部分API已经被证明是设计合理、符合需求的，但是其底层实现在后期维护中可能会发生细微改变，但能保证完善的向后兼容性（开发者不用关心底层实现的细微改变）。

4:冻结版-Frozen

这部分API已经在产品中被广泛使用而且其设计被证明是合理、稳定和有效的，在未来发展过程中基本不会发生改变。

5固化版-Locked

这部分API被认为没啥可以修改的——除非发现严重的bug，否则这部分API（包括底层实现）不会被修改。譬如你个人觉得固话版的API设计不合理，需要向设计人员反馈，那么你的反馈邮件很可能没有人看。