Vue和React，谁是更好的选择，这场争论似乎永远不会停止。但在某一点上，双方的粉丝似乎达成了难得的共识：Vue文档比React文档要好得多。React开发者对此的解释是：Vue是中国人开发的，写的文档当然更适合中国人。但从#3308[1]来看，全世界的React开发者似乎已经为文档苦苦挣扎了很长时间。以至于在这一期，ReactCoreTeam成员rachelnabors含泪表示：“为了弥补官方文档的不足，热心的开发者制作了很多React教程。我们希望如何从你写出第一个React开始直到你职业生涯的最后，公文才是陪伴在你身边的唯一‘他’。”随着对Hooks的认识越来越多，现有的文档都是围绕ClassComponent展开的，而Hooks只是一个独立的章节。由于这些原因，React团队决定重写文档。React文档难以理解的本质原因文档之间的差异真的只是因为“中国人写的文档更适合中国人阅读”吗？很明显不是。要理解文档的差异，就需要先说说框架的差异。Vue是基于一种抽象程度更高的“模板语言”开发的。从本质上讲，他的文档是对“模板语言”语法的介绍。然后只需记住所需的语法即可。React的抽象层次较低，直接使用JS（JSX只是语法糖）。与Vue语法相比，React需要花费大量的时间来讲解React中各种数据流和设计模式是如何使用的。君不见，为了解决组件复用，React有很多HOC、renderprops、组合模式等概念。这一次会很困难。新文件有哪些变化知道了症结所在，让我们看看新文件会有哪些变化。1、整篇文档对Hooks的使用，不再以ClassComponent为例，这也说明Hooks已经成为事实上的开发标准，得到了社区的认可。2.为编程初学者准备的“术语和概念解释”。React，包括Redux，喜欢（修改过，我很喜欢）用各种理论和概念（比如Hooks的代数效应）来指导工作。这让不少前端在惊叹“高大上”的同时，也发出了“不懂”的哀嚎。为此，新文件将增加对许多术语和概念的解释。3.更多示例图表、在线演示、集成开发工具和lint。图文结合方便理解，在线demo方便学习练习。双管齐下，用心良苦。而且，这份新文件是由丹·阿布拉莫夫亲自撰写的。前端顶级网红的关注度，可见一斑。何时才能见到这样的芬芳，何时才能见到？官方给出的答案是：2021年初。当前版本文档将被归档，新版本文档不会在当前版本文档的基础上进行修改。如果等不及，社区提供当前版本的基于Hooks的文档[2]来解决问题。参考文献[1]#3308：https://github.com/reactjs/reactjs.org/issues/3308[2]基于当前版本的Hooks文档：https://reactwithhooks.netlify.app/
