我这个标题，是不是很有自媒体的味道了😆

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

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

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

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

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

相关人物

Sixian

Sixian Li^[2]

尤雨溪

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

被盛赞的 React 文档

• • Keeping Components Pure – React^[3]

• • Synchronizing with Effects – React^[4]

• • Synchronizing with Effects – React^[5]

中文版：

• • 保持组件纯粹 – React 中文文档^[6]

• • 使用 Effect 同步 – React 中文文档^[7]

• • 你可能不需要 Effect – React 中文文档^[8]

往期推荐

• • 面了个十年经验的开发, 连 Session/Cookie/Token/JWT 都讲不明白

• • 2023读书总结：阅读600小时，推荐10本好书

• • 简易 Playwright 爬虫，帮你实现壁纸自由

• • 两个高质量电子书微信公众号，精排追求极致阅读体验

• • 2023年流行词汇大盘点2：內卷、躺平、精神內耗之后

欢迎关注我的公众号“码农真经”，原创技术文章第一时间推送。

引用链接

[1] Sixian on X: "React 的新版官方文档太棒了，把许多坑都直接列了出来，并用心地附上了例子解释这样为什么错，会导致什么样的问题，非常直观。我一直觉得掌握一个东西最有效的方法就是先 break it，知道它为什么坏，就能了解当前的设计到底是在解决什么问题。文档里让我收获最大的是关于 Effect… https://t.co/hfUig5W9c6" / X: https://twitter.com/noworkforsixian/status/1742574959241908434
[2] Sixian Li: https://www.sixian.li/
[3] Keeping Components Pure – React: https://react.dev/learn/keeping-components-pure#why-does-react-care-about-purity
[4] Synchronizing with Effects – React: https://react.dev/learn/synchronizing-with-effects
[5] Synchronizing with Effects – React: https://react.dev/learn/synchronizing-with-effects
[6] 保持组件纯粹 – React 中文文档: https://zh-hans.react.dev/learn/keeping-components-pure
[7] 使用 Effect 同步 – React 中文文档: https://zh-hans.react.dev/learn/synchronizing-with-effects
[8] 你可能不需要 Effect – React 中文文档: https://zh-hans.react.dev/learn/you-might-not-need-an-effect