你写代码爱写注释吗?程序员:我不写,但别人最好写!

w3cschool

共 3398字,需浏览 7分钟

 ·

2024-07-12 17:00

👆点击关注 回复『新人礼』获取学习礼包👆

知乎上有个关于“如何看待程序员不写注释这一现象”的讨论,浏览量达到78W+,热度很高。



可见大家对这个话题还是很感兴趣的,我浏览了大部分回答,发现大家的观点可以归纳为以下几点:


1️⃣不写注释可能会给自己和他人带来麻烦,因为随着时间的推移,即使是自己也可能会忘记代码的意图。

2️⃣如果代码的可读性很高,那么注释可能显得多余。

3️⃣只要有详尽的文档,代码就不需要注释。

4️⃣程序员在写代码时可能不愿意写注释,但在阅读别人的代码时,却希望对方有注释。


还有人总结了程序员最讨厌的四件事:写注释、别人不写注释、写文档、别人不写文档。



那么你最讨厌的事情是——


注释是代码的重要组成部分,但很多程序员却不愿意写,这是为什么呢?


01
程序员不写注释的原因


● 节约时间

一些程序员认为编写注释会消耗过多时间,因此经常忽略这一步骤。然而,精心编写的注释实际上是程序员对代码深层次理解和分析的反映,它对于增强代码的可读性和维护性至关重要。


● 认为注释可读性低

有些程序员认为代码本身应足够清晰,因此不需要额外的注释。但事实上,代码的解读通常需要特定的背景知识,而恰当的注释能够为那些不具备这些知识的人提供额外的指导和帮助。


● 偷懒

一些程序员可能出于懒惰或其他因素,选择忽略编写注释。这种行为不仅会降低代码的清晰度和可维护性,还可能对团队的协作精神和工作氛围造成不良影响。



02
如何解决这一现象


● 加强注释阅读的重要性

团队应当重视注释在提升代码质量和促进团队合作中的作用,鼓励开发者养成编写注释的良好习惯。例如,在代码审查过程中,应当特别留意注释是否规范、详尽,确保能够为代码的理解和维护提供有效支持。


● 提供更多的样板注释

公司可以制定一套代码编写规范和注释样板,为程序员提供标准化的注释模板。这种做法不仅能够简化注释的编写过程,降低其难度,而且有助于确保注释的一致性和质量。


● 强制要求写注释法规

当新成员加入团队或新任务被分配时,团队可以强制要求程序员在提交代码前添加必要的注释,这有助于逐步培养团队成员对注释重要性的认识和习惯。


● 提高代码可读性

程序员应当致力于提升代码的可读性,确保代码结构条理清晰、变量和函数命名规范,遵循良好的编程风格可以减少对注释的依赖。


● 使用适当的编码工具和插件

一些编码工具和插件具备自动生成注释的功能,这可以显著减少程序员手动编写注释的工作量,还可以提高编写注释的效率。


● 鼓励交流与分享

团队应该鼓励成员之间的交流与分享,以增强程序员对注释重要性的认识,并从中获得实际的好处。

点击名片回复『编程』

即可获取1000+编程学习手册

浏览 87
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报