繁体   English   中英

方法最佳实践结束时的评论?

[英]Comments at end of method best practice?

我有一些代码在每个方法之后都有注释,例如:

// End of contructor DbFactoryDBConnection()

这样的评论是否应该用于表示方法的结束? 这是从早期的就业中获得的东西,它是常见的地方。

我认为这样的评论是在身体不适合单个屏幕的方法之后。 我相信这是重构和拆分这么长的方法来缩短一些甚至是提取新的实体/服务/帮助的好方法。 这就像C#区域,有时它用于隐藏很长的代码块,这表明你有某种God Object反模式

不。如果您想知道大括号的关闭,而不滚动,您可以使用ReSharper 这在很多方面都很棒。

只需将光标放在大括号上,如果它们的开口不在视图中 - 它会在它之前对整行进行工具提示。

通常这种评论是一种过度的文件。
评论应该存在的正确位置是在您的课程和方法的开头,以及在您的代码中进行重要决策之前。
如果您发现需要记录IF,SWITCH或METHOD的结尾,则很可能需要重新检查您的代码以进行简化。

我认为这种评论完全没有必要,只会使代码混乱。 大多数IDE(例如Visual Studio)都具有突出方法(或其他)多年的功能,因此我不确定通过这样做可以为您的代码添加什么值。

你可以随时使用PowerCommands for Visual Studio,它在大括号的末尾添加注释你在使用它时是什么样的bracer,它有很多帮助:)

不,不应该使用这样的评论。 唯一的原因是,有人会使用像这样的评论这个方法太长了。 但即便如此,现代IDE还是向您展示了您当前使用哪种方法,甚至允许折叠方法回归到定义。
像这样的评论没有任何价值,只是污染了代码库。

这不属于源恕我直言; 与有效的源代码块不同步太容易了。 有一些扩展可以在Visual Studio中为您显示此信息,您觉得这很有帮助。

暂无
暂无

声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.

 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM