API 设计的艰难抉择
原文中文，约5400字，阅读约需13分钟。
📝
内容提要
在过去三个月，我对Silly进行了重构，统一了代码风格，明确了命名规则和API设计，优化了命名空间结构，简化了API，采用面向对象风格，解决了连接管理和数据读取的复杂性，提高了代码的可读性和维护性。
🔎
延伸解读
命名规则的重要性
在Silly的重构中，命名规则的统一显得尤为重要。所有导出函数控制在两个单词以内，既符合Lua的习惯，也能避免模块功能过于复杂。这种设计不仅提升了代码的可读性，还能帮助开发者快速理解和使用API，减少了学习成本。
面向对象风格的优势
重构后的API采用面向对象风格，简化了连接管理和数据读取的复杂性。这种设计使得代码结构更加清晰，使用者只需关注连接的创建和使用，而不必深入了解底层实现，从而提高了开发效率和代码的可维护性。
GC引用链的设计考量
在重构过程中，GC引用链的设计引发了对内存管理的深思。通过对挂起协程的管理，设计者考虑了如何在保证性能的同时，避免内存泄漏。这种设计的复杂性提醒开发者在进行系统架构时，需平衡性能与内存管理的需求。
❓
Q&A
Silly重构的主要目标是什么？
Silly重构的主要目标是统一代码风格，明确命名规则和API设计，优化命名空间结构，简化API，提升代码可读性和维护性。
在Silly的重构中，命名规则有什么特别之处？
所有导出函数的名称控制在两个单词以内，以兼容多样命名风格和Lua习惯，避免模块功能过于复杂。
Silly的API设计采用了什么样的风格？
Silly的API设计采用了面向对象风格，简化了连接管理和数据读取的复杂性。
conn:read的严格读取模式是怎样的？
conn:read的严格读取模式要求要么读取到完整的数据量，要么返回错误，不会返回部分数据。
Silly重构中如何处理未读取数据的字节数？
新增了conn:unreadbytes接口，用于返回当前连接剩余未读取数据的字节数。
重构过程中对GC引用链的设计考虑了哪些因素？
重构过程中重新审视了GC引用链设计，考虑了挂起协程的管理和内存清理的简洁性。
🏷️
