关闭。这个问题是opinion-based.它目前不接受答案。想要改进这个问题？更新问题，以便editingthispost可以用事实和引用来回答它.关闭8年前。Improvethisquestion我喜欢正确记录的代码，拥有正确记录的描述契约(Contract)的公共(public)方法对我来说是轻而易举的事，同样适用于解释代码内部/实现的私有(private)或包内部方法。但是我不确定我是否应该使用非公开和非protected方法:遵守所有手续，如参数、返回值和异常的描述如果我应该记录不言自明的私有(private)方法，例如fireSomeEvent，它的作用一目了然，因为这只会

大家好，我是辣条。同样的开场白，我竟然有了一点点陌生，或许是不在同一个账号，或许是停了一段时间码字了，又或许是心态受到了很大的影响...不管怎么说，又和大家见面了，见字如面，甚是想念，不错我就是辣条，我重新归来，重新起航了。前言在大家看到这篇文章的时候，事情已经结束了，没有反转，发布该文章目的只有一个：警示、铭刻、鞭笞自己，纵有疾风起，人生不言弃。记录在准备写这篇文章的时候，其实是有很多话想说的，但是开始码字的时候却不知道从哪说起。今天在刷B站的时候看到罗翔老师的一个视频，讲的是一个真实的例子，内容大致如下：多年前，有一个人高考没考好，有人跟他说，你只要交钱，就可以先上车后补票，后来他进入一个