Python 注释

史鼐
• 阅读 138

Python中的注释有单行注释和多行注释。

Python 是使用 # 来进行注释的。这个等于是我们在 Java 中使用的 // 符号。

请考察下面的代码

print("Hello, CWIKIUS!")  # Python 行内注释

# Python 单行注释
print("Hello, CWIKIUS!")

# Python 多行注释 - LINE 1
# Python 多行注释 - LINE 2
print("Hello, CWIKIUS!")

'''
Python 多行注释块 - LINE 1
Python 多行注释块 - LINE 2
'''
print("Hello, CWIKIUS!")

"""
Python 多行注释块 - LINE 1
Python 多行注释块 - LINE 2
"""
print("Hello, CWIKIUS!") 

如果你使用 IDE读取上面的代码的话,IDE 会帮你使用不同的颜色来进行表示。

Python 注释

如上图显示的在 IDE 中使用颜色的表示。

行内注释

正常来说,对于行内注释,你可以直接在代码后面添加 # 符号后再添加注释内容,这种注释方法是行内注释。

块注释

如果你的注释是另起一行的话,那么表示的注释为单行或者多行注释。

单双引号

在上面的代码上,我们可以看到你还可以使用单引号和双引号来标记为注释。

因为 Python 将会忽略任何没有指派变量的文字,因此你可以使用添加单引号和双引号的方法来标记注释,如上面的代码所显示的那样。

Python 解释器针对上面的代码将会先读进解释器,但是因为没有指派变量或者值,Python 将会忽略掉上面的代码,这个就是为什么你可以使用单引号或者双引号来进行注释的原因。

从 IDE 的界面你可以看到,正常 Python 的注释是灰色的,如果你使用了单引号和双引号的注释,IDE 上面并没有为你标记为灰色,这是因为这部分的内容还是会被 Python 解释器读取的。

所以可以根据你的实际需要选择不同的注释方式,不管使用 # 号还是引号都是没有问题的。

不是注释

下面的内容不是注释。

有时候你将会在 Python 代码的开头的第一行看到下面的内容:

#!/usr/bin/python3 

上面的代码表示的是这个脚本使用的是 Python 3 解释器的脚本。

这是脚本语言需要共同遵守的规则:当第一行为 #!/path/to/script/interpreter 时,指定了用来执行本脚本的解释器。

使用这个需要注意下面的内容一些内容:

  1. 必须是文件的第 1 行
  2. 必须以 #! 开头。正是因为这个,会容易让人以为这个语句是 Python 的注释。
  3. /path/to/script/interpreter 是脚本解释器的全路径名。
# -*- coding: utf-8 -*-

上面的代码也是在 Python 程序的开头第 1 行后面,如果第 1 行指定了解释器的路径的话,那指定代码的编码的代码就在第 2 行。

上面用于指定代码使用 UTF-8 编码,通常是需要的。

在一般的 Python 程序中,你可能会看到:

#!/usr/bin/python3 
# -*- coding: utf-8 -*-

上的内容,然后才是 Python 的代码,上面的内容表示的是当前 Python 使用的编译器版本和 Python 代码使用的字符集。

可以说上面 2 行通常都会有,或者只有一行,或者根本就没有。

我们在这里列出来主要是为了避免与注释的混淆。

https://www.ossez.com/t/python/13383

点赞
收藏
评论区
推荐文章
Wesley13 Wesley13
4年前
java基础之 java注释
JAVA里有2中注释风格。一种以“/\”开始以“\/”结尾,另一种是以“//”起头的。被注释的内容不会被java虚拟机编译,所以这就是为什么用反编译编译源代码没有注释的原因。举个栗子packagetest;publicclassJavaDoc{/这是单行注释/
Wesley13 Wesley13
4年前
java入门第二章——java编程基础
习题 一、填空题(p)1.java中的程序代码都必须在一个类中定义,类使用(class)关键字来定义。(p)2.布尔常量即布尔类型的两个值,分别是(true)和(false)(p18)3.java中的注释可分为三种类型,分别是(单行注释)(多行注释)(文档注释)(p24)4.java中的变量可分为两种数
Wesley13 Wesley13
4年前
javaDoc
我们知道Java中有三种注释语句:1.//用于单行注释。2./\...\/用于多行注释,从/\开始,到\/结束,不能嵌套。3./\\...\/则是为支持jdk工具javadoc.exe而特有的注释语句。   javadoc工具能从java源文件中读取第三种注释,并能识别注释中用@标识的一些特殊变量(见表),制作成Htm
lucien-ma lucien-ma
4年前
python文件的第一行 #!/usr/bin/python3 是什么意思?
python文件的第一行代码通常在脚本语言的第一行会看到:!/usr/bin/envpython或!/usr/bin/python首先要确定的一点是它不是注释。这两句话的目的都是指出你的python文件用什么可执行程序去运行它。1.!/usr/bin/python是告诉操作系统执行这个脚本的时候,调用/usr/bin下的python解释
Stella981 Stella981
4年前
Python 字符串与基本语句
Python特点python中没有变量的声明语句结束后没有分号严格要求缩进支持很长很长的大数运算(直接在Idle中输入即可)用“”来注释BIF:Bulitinfunctions(内置函数)input
Wesley13 Wesley13
4年前
JavaSE 基础大纲
Java基础(JavaSE)1、Java基础语法;1、1注释行内注释//多行注释/\\/文档注释/\\\/javadoc生成帮助文档1、2标识符关键字1、3数据类型1、基本数
Wesley13 Wesley13
4年前
C++ 注释
C注释程序的注释是解释性语句,您可以在C代码中包含注释,这将提高源代码的可读性。所有的编程语言都允许某种形式的注释。C支持单行注释和多行注释。注释中的所有字符会被C编译器忽略。1include<iostream23/runthisprogramusingthe
Wesley13 Wesley13
4年前
Java语言基础
一,注释1,分类单行,多行,文档注释2,文档注释a,生成APIb,用法:javadoc 注:ApplicationProgrammingInterfaces应用程序编程接口(其实就是说明书)3,注释是不会出现字节码文件里的二,包1,简述a,包是用来管理类的,类似文件夹管理文件b,其作用为防止命
Wesley13 Wesley13
4年前
MySql的基操勿六
2018/12/6星期四19:34:07authotbydabaine数据库注释;这就是注释/...../这也是注释创建库;createdatabseifnotexistsdabainecharact
小万哥 小万哥
2年前
Python 注释:解释和优化代码可读性
注释可以用来解释Python代码。注释可以用来使代码更易读。注释可以用来在测试代码时防止执行。创建注释注释以开始,Python会忽略它们:示例:获取您自己的Python注释Python这是一个注释print("Hello,World!")注释可以放在一行的
小万哥 小万哥
2年前
C 语言注释和变量详解
C语言中的注释C语言中可以使用注释来解释代码并使其更具可读性。它还可以在测试替代代码时防止执行。单行注释单行注释以两个斜杠(//)开头。//和行末之间的任何文本都会被编译器忽略(不会被执行)。此示例在代码行之前使用单行注释:c//这是一个注释printf(