最近 Hacker News 上一篇题为《当代码成为迷宫，优秀的开发者会绘制地图》的文章，引发了关于文档最佳实践和编辑器偏好的一场热烈讨论。 尽管文章认为注释是引导理解复杂代码库的重要“地图”，但许多开发者反驳道，高质量且直观的架构（以清晰的命名、关注点分离和简洁的文档为特征）完全无需冗长的注释。 讨论很快转向了关于格式的技术争论。参与者们就单行注释与自动换行注释的优劣展开辩论，探讨代码阅读方式究竟应由 IDE 的代码折叠功能决定，还是由软换行功能决定。正如经典的“Vim 与 Emacs”之争，该讨论凸显了行业内始终缺乏共识：开发者们在“坚持严格、标准化的可读性”与“追求配置个人编辑环境的自由”之间各执一词。归根结底，这场讨论提醒我们，开发者的工作流程具有高度的主观性，在管理代码复杂性方面，不存在所谓的“一刀切”方案。