Vue和React，誰才是更好的選擇，這個(gè)爭(zhēng)論似乎從未停過。但在一點(diǎn)上，雙方粉絲似乎達(dá)成了難得的一致：

Vue文檔比React文檔好太多。

React開發(fā)者對(duì)此的解釋是：Vue是國人開發(fā)的嘛，寫出來的文檔當(dāng)然更符合中國人看啦。

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

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

隨著Hooks認(rèn)可度越來越高，可現(xiàn)有文檔是圍繞ClassComponent展開的，Hooks只是一個(gè)獨(dú)立章節(jié)。

基于這些原因，React團(tuán)隊(duì)決定重寫文檔。

React文檔難懂的本質(zhì)原因

文檔之間的差異真的僅僅因?yàn)?ldquo;中國人編寫的文檔更適合中國人看”?顯然不是。

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

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

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

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

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

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

這一下就難了。

新文檔有哪些改動(dòng)

知道問題的癥結(jié)，讓我們看看新文檔會(huì)有哪些改動(dòng)。

1.以Hooks的使用貫穿整個(gè)文檔

不再以ClassComponent舉例，這也表明Hooks成為事實(shí)上的開發(fā)標(biāo)準(zhǔn)已經(jīng)獲得社區(qū)的認(rèn)可。

2.為編程小白準(zhǔn)備的“術(shù)語、概念解釋”。

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

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

為此，新的文檔會(huì)增加很多術(shù)語、概念的解釋。

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

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

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

什么時(shí)候能看到

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

當(dāng)前版本文檔會(huì)歸檔，新版文檔不會(huì)在當(dāng)前版本文檔基礎(chǔ)上修改。

如果等不及了，社區(qū)提供了基于Hooks的當(dāng)前版本文檔[2]解解饞。

參考資料

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