Python 中如何写注释

作者:雪梦科技 时间:2022-07-10 21:53:11 

在写 Python 代码的时候,一个很好的编码实践就是使得你的代码简洁,易懂。组织代码,设置变量,以及给函数有意义的名字,都是几个不错的方法。

另外一个提高代码可读性的方式就是使用注释。一个注释就是可以用来解释代码的一段人类可读的解释或者一个注解。例如,如果你写了一个复杂的正则表达式,你可以添加一个注释,描述代码做了什么。

在你的 Python 代码中添加注释,在将来你阅读你的代码时,可以节省很多的时间和努力。比如说,你想修改一段你在几个月前或者几年前写的脚本。很可能你不记得为什么你写了一些比较复杂的代码,除非你添加一段注释。这个注释同时也可以帮助其他开发者理解你的代码,以及代码的目的。

注释应该很短,并且切中要点。不要解释那些很容易读懂的代码。

本文主要讲解在 Python 中编写注释的基础知识。

一、在 Python 中写注释

Python 会忽略井号(#)后面的一切。

注释可以添加到行首或者和其他代码在一行。


# This is a Python comment.
print("Hello World") # This is an inline Python comment.

井号后面的空格不是强制性的,但是它会提高注释的可读性。

在字符串中间的井号并不意味着是一段注释的开始。此时,它仅仅是一个简单的井号。


paragraph = "# Hash inside quotes is not a comment."

Comments should be at the same indent level as the code beneath it:

```py
def factorial(n):
if n == 0:
return 1
else:
# Use the factorial function
return n * factorial(n-1)

如果你的文本编辑器支持语法高亮,注释通常都使用绿色代表。

注释在调试脚本的时候非常有用。与其删除一些行或者代码块,不如将他们暂时注释掉:


# for fruit in fruits:
# print(fruit)

二、Python 中的多行注释(注释块)

不像其他流行的编程语言,Python 仅仅支持单行注释。

在 Python 中编写多行注释的最简单方式就是每行添加一个注释。


# This is the first line.
# This is the second line.

另外一个选项就是使用 docstrings

Docstrings 是一个多行字符串,用来对模块,函数,类和方法进行文档化的。

一个 Docstrings 以(""") 开始,可以是 一行或者多行:


"""This is
a multiline
docstring.
"""

Docstrings 不是技术性的注释。当 Docstrings 在模块,函数,类,或者方法的前面出现的时候,它在字节码中结束,并且变成__doc__特殊属性的对象。

你更应该使用单行注释。

三、Shebang

如果你阅读 Python 脚本,你可能注意到第一行以#!字符开始,接着是 Python 解释器的路径。


#!/usr/bin/env python3

这一串字符串被称为shebang,它被用来告诉操作系统,应该使用什么解释器来解析文件。脚本以 shebang 开头,并且可以在终端中直接运行,而不用在脚本输入python

因为 shebang 以 井号开头,它被认为是一个注释,并且自动被 Python 解释器忽略。

四、总结

编写注释是一个非常好的实践,它帮助其他开发者,包括未来的自己,来理解这段代码在做什么。

在 Python 中,所有以井号开头的直到行末的,都被认为是一段注释。

来源:https://cloud.tencent.com/developer/article/1655148

标签:python,注释
0
投稿

猜你喜欢

  • windows10下python3.5 pip3安装图文教程

    2023-02-25 02:06:44
  • 用VB编写ActiveX DLL实现ASP编程

    2008-10-21 21:28:00
  • python实现控制台打印的方法

    2021-12-18 12:21:04
  • python验证身份证信息实例代码

    2022-11-19 13:36:24
  • Python学习之列表常用方法总结

    2021-11-24 18:43:19
  • MySql学习笔记之事务隔离级别详解

    2024-01-21 23:54:28
  • 屏蔽Flash 右键菜单的方法

    2008-05-24 07:21:00
  • Go 值传递与引用传递的方法

    2023-06-25 03:11:11
  • SQL Server误区30日谈 第2天 DBCC CHECKDB会导致阻塞

    2024-01-14 10:09:11
  • PSD to CSS —— CSS布局实战新概念系列教程

    2009-05-30 16:40:00
  • 设计从"心"开始

    2011-05-21 08:37:00
  • css中使用CLASS来设计网页布局

    2007-10-30 13:01:00
  • Asp 返回引用类型函数代码

    2011-03-10 10:44:00
  • Mysql如何查看是否使用到索引

    2024-01-25 09:58:06
  • Laravel配置全局公共函数的方法步骤

    2023-11-15 01:20:42
  • 浅谈keras中的后端backend及其相关函数(K.prod,K.cast)

    2021-07-04 08:53:54
  • Python中时间datetime的处理与转换用法总结

    2022-05-03 01:23:01
  • 详解python3安装pillow后报错没有pillow模块以及没有PIL模块问题解决

    2021-08-28 15:42:10
  • Python3 关于pycharm自动导入包快捷设置的方法

    2021-10-11 02:08:01
  • PHP接口多继承及tarits实现多继承效果的方法

    2023-11-21 04:23:33
  • asp之家 网络编程 m.aspxhome.com