Vue和React，誰才是更好的選擇，這個爭論似乎從未停過。但在一點上，雙方粉絲似乎達成了難得的一致：

Vue文檔比React文檔好太多。

React開發者對此的解釋是：Vue是國人開發的嘛，寫出來的文檔當然更符合中國人看啦。

但從#3308[1]來看，似乎全球React開發者都苦文檔久矣。以至于在這個issue中，React Core Team成員rachelnabors聲淚俱下的說：

“為了彌補官方文檔的不足，熱心的開發者們自制了很多React教程。我們多么希望從你編寫第一個React組件開始，直至你職業生涯的終結，官方文檔都是唯一那個陪在你身邊的‘他’啊”。

隨著Hooks認可度越來越高，可現有文檔是圍繞ClassComponent展開的，Hooks只是一個獨立章節。

基于這些原因，React團隊決定重寫文檔。

React文檔難懂的本質原因

文檔之間的差異真的僅僅因為“中國人編寫的文檔更適合中國人看”?顯然不是。

要理解文檔的差異，需要先談框架的差異。

Vue基于“模版語言”開發，抽象程度更高。本質上他的文檔就是介紹“模版語言”的語法。

那么就把需要的語法背下來就行了。

而React抽象程度更低，直接使用JS(JSX僅僅是語法糖)。

相比于Vue語法靠背就行，React需要花大篇幅講解各種數據流、設計模式如何在React中使用。

君不見為了解決組件復用，React有HOC、render props、組合模式等眾多概念。

這一下就難了。

新文檔有哪些改動

知道問題的癥結，讓我們看看新文檔會有哪些改動。

1.以Hooks的使用貫穿整個文檔

不再以ClassComponent舉例，這也表明Hooks成為事實上的開發標準已經獲得社區的認可。

2.為編程小白準備的“術語、概念解釋”。

React，包括Redux很喜歡(修改下，是非常喜歡)用各種理論、概念指導工作(比如代數效應之于Hooks)。

這讓很多前端一邊驚嘆“高大上”一邊哀嚎“看不懂”。

為此，新的文檔會增加很多術語、概念的解釋。

3.更多的示例圖，在線demo，集成Dev-tools和lint。

圖文并茂方便理解，在線demo方便邊學邊練。雙管齊下，用心良苦。

并且，這次新文檔由蛋總(Dan Abramov)親自操刀。前端屆頂級網紅出馬，重視程度可見一斑。

什么時候能看到

這么香，什么時候能看到呢?官方給出的答案是：2021年初。

當前版本文檔會歸檔，新版文檔不會在當前版本文檔基礎上修改。

如果等不及了，社區提供了基于Hooks的當前版本文檔[2]解解饞。

參考資料

[1]#3308: https://github.com/reactjs/reactjs.org/issues/3308[2]基于Hooks的當前版本文檔: https://reactwithhooks.netlify.app/