首页技术文章正文

Python中什么情况下需要使用注释?

更新时间:2021-08-25 来源:黑马程序员 浏览量:

IT培训班

在注释代码的时候我们应当注意:

  1. 注释不是越多越好,对于一目了然的代码,不需要添加注释

  2. 对于 复杂的操作,应该在操作开始前写上若干行注释

  3. 对于 不是一目了然的代码,应在其行尾添加注释(为了提高可读性,注释应该至少离开代码 2 个空格)

  4. 绝不要描述代码,假设阅读代码的人比你更懂 Python,他只是不知道你的代码要做什么


在一些正规的开发团队,通常会有代码审核的惯例,就是一个团队中彼此阅读对方的代码,找出和发现在开发中出现的错误并及时订正,预防代码出现错误,提高代码的安全性。减少后期的软件检查。而注释代码就是为了给同事或者同行提供便利,以求更快的理解你写这行代码的意思,知道你要做什么。
 

关于代码规范

Python 官方提供有一系列 PEP(Python Enhancement Proposals) 文档

其中第 8 篇文档专门针对 Python 的代码格式 给出了建议,也就是俗称的 PEP 8

文档地址:https://www.python.org/dev/peps/pep-0008/

谷歌有对应的中文文档:http://zh-google-styleguide.readthedocs.io/en/latest/google-python-styleguide/python_style_rules/






猜你喜欢:

Python基本语法:注释

什么是注释?Java中的注释都有哪几种?

黑马程序员Java培训

分享到:
在线咨询 我要报名
和我们在线交谈!