Python代码注释


在工作中你会发现,一个项目是由多个开发人员一起做,你要调用别人写的代码,别人也要调用你的,如果代码不加注释,不说别人看不懂,自己可能过段时间也会看不懂,所以为避免这种情况发生,一定要增加你代码的可读性。

代码注释分单行和多行注释,单行注释用#,多行注释用可以用三对双引号"“”“”", 当然用#号也可以,不过就是每一行前面都要添加#号。

单行注释

Python编程语言的单行注释常以#开头,单行注释可以作为单独的一行放在被注释代码行之上,也可以放在语句或者表达式之后。

示例,忽略代码意思。

# _*_coding:utf-8_*_

count = 0
while count <= 100:  # 只要count<=100就不断执行下面的代码
    print("loop ", count)
    if count == 5:
        break
    count += 1  # 每执行一次,就把count+1,要不然就变成死循环了,因为count一直是0

print("-" * 4 + "out of while loop" + "-" * 4)

多行注释

多行注释使用单引号和双引号都可以,示例如下:

"""
多行注释,双引号
多行注释,双引号
多上注释,双引号
"""

'''
多行注释,单引号
多行注释,单引号
多行注释,单引号
'''

代码注释快捷键

选中要注释的代码,按下ctrl+/注释
取消注释使用同样的方法,选择要取消注释的代码,按下Ctrl+/取消注释

代码注释原则

  1. 不用全部加注释,只需要在自己觉得重要或者不好理解的部分添加注释即可
  2. 注释可以使用中文和英文,但绝对不要使用拼音
  3. 注释不光要给自己看,还要给别人看,所以请认真写撒
  4. 注释写在语句后方时,“#”和代码空两格!
  5. 在Pycharm中,可以使用Ctrl + Alt + L ,快速规范代码使其符合PEP8的规范,当然只是调整空行、空格一类,并不会帮你添加注释
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

江上月༻

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值