docs: suggest adding performance comparison table for fs.promises vs callback API
未关闭
还没有人认领这个 Issue。
- 主要语言
- JavaScript
- 星标
- 122k
- 派生
- 37.4k
- 平均合并
- 4 天 3 小时
- 30 天内合并 PR
- 272
描述
建议
在 fs 模块文档中添加一个性能对比说明，解释 fs.promises API 与传统 callback API 在性能上的差异和适用场景。
背景
很多开发者在选择文件系统 API 时不清楚 promises 和 callback 版本的性能差异。添加以下内容会很有帮助：
- 高并发场景下的性能表现差异
- 内存使用对比
- 何时应该使用 callback 版本以获得最佳性能
这对于构建高吞吐量的 Node.js 应用很有参考价值。
贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
调研方向
从 fs 模块文档及其中现有的 promises 和 callback APIs 描述开始。在添加比较之前，研究或核实所要求的关于高并发性能、内存使用和 callback 选择的指导。完成的标准是文档清楚地涵盖这三点，同时不过度夸大没有依据支持的差异。
由索引模型根据 Issue 内容生成。
评估
- 技术栈
- node.js
- 领域
- documentation
- Issue 类型
- 文档
- 难度
- 3/5
- 预计耗时
- 1-2 天
- 活跃度
- 活跃
- 描述清晰度
- 基本清楚
- 新手友好度
- 68/100