让更多的人读懂你的代码--注释

学习任何一门编程语言的开始都需要学习它的注释怎么写,注释可以帮助我们理解代码的意图。

注释是啥?

计算机编程的本质就是传递信息,好的代码不仅能够把程序员的指令传递给计算机,还能够把程序员的意图传递给其他阅读代码的人。

注释的存在正是为了帮助人们理解代码的意图,它不会对程序的行为产生任何影响。

python的两种注释

单行注释

在python中单行注释使用#,#后直到行尾的内容会被忽略,不会被python解释器执行。

在这里插入图片描述
image-20210430155008515

多行注释

在python中多行注释使用一对三引号''' '''/""" """(英文状态下),三引号之间的所有内容都会被忽略,不会被python解释器执行。

在这里插入图片描述
image-20210430155504445

如何用好注释呢?

一个好的开发者的标志之一就是他的注释:在该注释的地方注释,在不需要注释的地方则不注释,甚至写得好的自描述函数本身就是一种注释。

好的注释可以使我们更好地维护代码,一段时间之后依然可以更高效地回到代码高效开发。

注释这些内容:

  • 整体架构,高层次的观点。
  • 函数的用法。
  • 重要的解决方案,特别是在不是很明显时。

避免注释:

  • 描述“代码如何工作”和“代码做了什么”。
  • 避免在代码已经足够简单或代码有很好的自描述性而不需要注释的情况下,还写些没必要的注释。

文末

以上就是注释的一些基本知识,如果你觉得我写的不错,就请给个赞赏吧,欢迎扫一扫下方二维码关注我的微信公众号,获取更多python知识哦~
在这里插入图片描述

更多精彩python教程请来B站关注我哦:https://www.bilibili.com/video/BV1K84y1c7v4

  • 1
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 1
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值