注释之背后:代码的解释者与保护者

简介: 注释之背后:代码的解释者与保护者

注释之背后:代码的解释者与保护者


引言 作为一个编程不到一年的初学者来说,想借此机会说说我对 “代码是否写注释” 这个问题的一些看法.

在了解并学习java编程语言之后,我对"面向对象编程"这几个字愈加深刻也逐渐有了自己的理解,我们通过观察现实世界中存在的客体的属性和行为,抽象成一个个虚拟的对象,然后再将这些对象实例化,在计算机上利用这些实例化的对象对现实世界进行模拟,解决可能问题和实现功能.这就是我理解的面向对象编程。像面向对象编程一样,注释也应该成为你编写代码的一部分。那么你的注释是否应该同样是面向对象注释呢?

正如我们通过对象的属性和行为来理解现实世界一样,注释通过解释代码的属性和行为来帮助其他开发人员理解你的虚拟对象(即代码)。所以注释需要面向的对象有两个方面: 代码和读者。

因此,注释需要将代码和读者联系起来,那么它需要在这两者之间需要扮演这样的角色 :

  • 代码的解释者,有助于传达代码的背后意图和设计决策。
  • 代码的保护者,有助于减少风险、预防错误和提高代码的可维护性。

代码的解释者

有些人认为,代码本身应该是自解释的,也就是说,良好编写的代码应该清晰易懂,无需额外的注释。这是一种重要的观点,因为过度依赖注释可能意味着代码本身质量不高。**所以此时的注释应该用来解释为什么要这样做,而不是解释正在做什么。**这样你的代码依旧保持了优雅,而注释则会成为你代码的最佳拥护者。所以我们需要发挥自己的能力和思考让注释成为代码的优秀解释者。

学习编程的中我时常会遇到各种大大小小的难题,当我想要解决这些难题的时候,会上网查,看到有解决此类问题的博客,而很多优秀的博客中的编写的代码都有注释,很多时候我会因为一个好的注释而瞬间被点醒!


代码的保护者

注释就像是给你的代码贴上便签,提醒问题、解释意图,并指导修改,使代码更容易理解和维护。

你可以用注释来标记代码中可能有的问题或需要改进的地方,这帮助读者或者团队快速发现和修复错误,减少潜在风险。也可以指导其他人如何修改代码,以确保他们不会破坏现有功能。同时, 注释可以为代码提供上下文,使读者了解代码的特殊情况和约束条件。


总结

以上就是我对代码是否注释问题的看法,我始终认为真正优雅的代码,加上好的注释是锦上添花 !

目录
相关文章
|
6天前
|
设计模式 算法 前端开发
有什么可以减少注释,但依然能让他人看得懂代码的方法吗?
有什么可以减少注释,但依然能让他人看得懂代码的方法吗?
30 0
|
2天前
|
程序员 开发者
欢迎讨论--你见过哪些独特的代码注释
【5月更文挑战第11天】欢迎讨论--你见过哪些独特的代码注释
|
6天前
|
算法 程序员 开发者
探寻代码世界中的独特注释
作为开发者在编程开发中,注释是我们编写的代码中不可或缺的一部分,尽管我们常常强调清晰的代码本身就是最好的文档,但注释依然在软件开发的全生命周期中发挥着不可替代的关键作用,扮演着关键的角色,帮助我们更好地理解和维护代码。而在代码注释的海洋中,有时我们会发现一些独特而富有创意的注释,它们既有幽默感,又蕴含着智慧,或让人会心一笑,或引发深思。有些注释展现了开发者的幽默和创造力,通过有趣的文字让我们在编码过程中轻松一笑;有些注释则引发了思考,激发了我们对更好解决方案的探索和思考;还有些注释融入了文化和历史元素,为代码增添了趣味和人文关怀。代码注释不仅仅是对代码功能的解释,更是程序员与读者之间的沟通桥梁
12 1
探寻代码世界中的独特注释
|
7月前
|
人工智能 自然语言处理 Java
提高代码可读性的秘诀:注释的重要性
A:你写代码怎么连注释都不加? B:老大为什么要加注释? A:你不加注释,你怎么知道我能看懂你的代码? B:遇到问题你找到就可以了啊? A:那你哪天生病了请假了闹情绪了离职了,公司怎么办? B:我现在反正没觉得有什么问题,我对公司也很满意,安心啦! 又是00后整顿职场的一段精彩演绎。不可置否,在实际的软件开发过程中,确实有很多开发人员依然不愿意写注释认为这会浪费时间,或者自认为他们的代码足够清晰,不需要额外的解释。但这种想法too young too simple,代码注释对于项目的质量和效率有着深远的影响,在软件开发中的重要性不容小觑。
|
8月前
|
PHP 开发者
|
10月前
|
程序员
相见恨晚的Matlab编程小技巧(2)-代码怎么做到逻辑清晰?——巧用注释符“%“
        本文将以教程的形式详细介绍Matlab中两个常用符号“%”和“%%”的作用。初学者可以通过此文掌握这两个符号的用法,为Matlab编程打下坚实的基础。
|
11月前
自 创 日 历 (在代码里有注释讲细节)
做日历主要是要确定好第一天是星期几,然后算间隔多少天,算出具体这一天是星期几,然后把我们想打印的打印出来,把每个月的第一天定位到该在的地方。
51 0
|
NoSQL Java 数据库
解释afterPropertiesSet方法的用处
解释afterPropertiesSet方法的用处
|
程序员
代码界10个最“牛叉”的代码注释
要说到代码注释这个东西吧,其实很神奇,因为不管写不写注释,其实对于代码的运行没有任何的影响,注释的长短也没关系,因为编译器会对于所有的代码注释都是过滤掉的,其实注释非常重要,对后期的代码维护和重构至关重要,但是其实很多程序员童鞋在写代码时往往并不注意注释,所以导致自己回头看自己的代码时也都忘了写的是什么,本文给出了 StackOverflow 网友针对“你看到过的最好的代码注释是什么样的?”这个问题给出的回答的前10条。
6243 0