最近，React 官方文档更新了，前微软女工程师 Sixian Li 在 Twitter 盛赞 React 文档写的好，把一些常见的错误列了出来，并附上了例子，解释了为什么会出错，以及会导致什么样的问题。Vue.js 的创始人 Evan You ，对此发表的反对的意见。

Sixian on X: “React 的新版官方文档太棒了，把许多坑都直接列了出来，并用心地附上了例子解释这样为什么错，会导致什么样的问题，非常直观。我一直觉得掌握一个东西最有效的方法就是先 break it，知道它为什么坏，就能了解当前的设计到底是在解决什么问题。 文档里让我收获最大的是关于 Effect… https://t.co/hfUig5W9c6” / X

尤雨溪 认为，一个框架应尽可能减少自身的缺陷，而不是通过文档来弥补。

个人是比较赞同尤雨溪的观点的，文档应该是用来解释框架的设计思路，而不是用来解释框架的缺陷，教人如何避开它，进一步增加了学习成本。

当然，没有任何框架是完美的，都有自己的缺陷。这个时候，有文档总比没有文档好。

相关人物

Sixian

Sixian Li

尤雨溪

Evan You（尤雨溪）是一位知名的软件工程师，他是Vue.js框架的创始人。Vue.js是一种流行的JavaScript框架，用于构建用户界面和单页面应用程序。Evan You在开发Vue.js时致力于提供一种简单灵活的解决方案，以便开发人员可以更轻松地构建复杂的Web应用程序。Vue.js因其简洁、高效和易用而备受欢迎，成为了许多开发人员喜爱的选择之一。

被盛赞的 React 文档

• Keeping Components Pure – React

• Synchronizing with Effects – React

• Synchronizing with Effects – React

中文版：

• 保持组件纯粹 – React 中文文档

• 使用 Effect 同步 – React 中文文档

• 你可能不需要 Effect – React 中文文档