注释就像使得指定的代码不言而喻并具有高度可读性的路标。在Python中,我们可以添加单行和多行Python注释。这篇文章将详细介绍这两种方法。阅读完这些之后,您将知道如何添加Python注释以及使用哪种样式的注释。
写注释是一种很好的编程习惯。它们是代码中不可执行的部分,但在程序中非常重要。这些不仅可以帮助其他程序员在同一个项目上工作,而且测试人员还可以参考白盒测试的清晰度。最好在创建或更新程序时添加注释,否则可能会丢失上下文。后面写的注释可能不如他们应该那样有效。
在这里我还是要推荐下我自己建的Python开发学习群:483546416,都是学Python开发的,如果你正在学习Python ,小编欢迎你加入,今天分享的这个案例已经上传到群文件,大家都是软件开发党,不定期分享干货(只有Python软件开发相关的),包括我自己整理的一份2017最新的Python零基础资料和Python进阶教程,欢迎进加入
接下来我们带着下面这几个问题进入学习当中。
1.如何在Python中使用注释?
2.如何在Python中使用单行注释?
3.如何在Python中使用多行注释?
使用散列标记进行注释?
4.如何在Python中使用docstrings?
对文档字符串使用三引号标记
docstring与Python中的注释
5.Python注释,多行注释和DocString
注释是一种表达程序将在非常高级别上做什么的艺术。这些标记的文本行用于注释一段代码。在Python中,我们可以应用两种风格的评论:单行和多行。
单行Python注释
当需要简短快速的调试注释时,您可能更喜欢使用单行Python注释。单行注释以(#)符号开头,并自动以EOL结尾(行尾)。养成良好的代码编写习惯。
print(“Learn Python Step by Step!”)
在发表注释时,请确保您的注释与其下面的代码具有相同的缩进级别。例如,您可能注释了一个没有任何缩进的函数定义。但是该函数可能有多个级别缩进的代码块。因此,当您在内部代码块中进行注释时,请注意对齐。
多行Python注释
Python允许注释跨越多行。这些注释被称为多行或块注释。您可以使用这种注释风格来描述更复杂的内容。这种扩展形式的注释适用于以下部分或全部代码。以下是使用多行Python注释的示例。
使用散列(#)标记
要添加多行注释,您应该开始每行使用(#)符号,后跟一个空格。您可以将注释分成段落。只需在每个段之间添加一个带有散列标记的空行。
注意:符号(#)也被称为八足形。这个术语来自贝尔实验室的一组工程师,他正在研究第一个按键式键盘项目。
#要学习任何语言,您必须遵循以下规则。
1.了解基本语法,数据类型,控制结构和条件语句。
2.学习错误处理和文件I / O。
3.阅读有关高级数据结构
4.编写函数并遵循OOP概念。
Python中的Docstring
Python具有文档字符串(或文档字符串)功能。它为程序员提供了一种简单的方法来为每个Python模块,函数,类和方法添加快速笔记。您可以通过将其添加为字符串常量来定义文档字符串。它必须是对象(模块,函数,类和方法)定义中的第一条语句。文档字符串的范围比Python注释的范围更广。因此,它应该描述该功能的功能,而不是如何。另外,程序的所有功能都有一个文档字符串是一种很好的做法。
如何在Python中定义Docstring?
您可以借助三引号标记定义文档字符串。在开头添加一个,在字符串的末尾添加一个。就像多行注释一样,docstring也可以重叠到多行。
注意:使用三引号标记定义的字符串是Python中的docstring。但是,您可能会认为这是常规注释。
注释和文档字符串有什么区别?
以三重引号开头的字符串仍然是常规字符串,除了它们可以传播到多行。这意味着它们是可执行语句。如果它们没有标记,那么只要代码执行,它们就会被垃圾回收。
Python解释器不会像注释那样忽略它们。但是,如果将这样的字符串放在函数或类定义之后,或者放在模块之上,那么它们会变成文档字符串。您可以使用以下特殊变量来访问它们。
myobj.__doc__.__doc__
例:
注释和文档字符串为程序添加值。它们使您的程序更具可读性和可维护性。即使您稍后需要重构相同的代码,那么使用可用的注释也会更容易。软件在开发过程中只花费10%的时间,在维护中花费90%的时间。因此,总是会提供相关且有用的注释或文档,因为它们会导致更多的协作并加速代码重构活动。
如果你今天学到了新的东西,那么别介意进一步分享它。并且可以关注我后续一系列Python的相关文章。