【Python入门】01 Python注释、行与缩进及PEP 8编码规范_python中哪种注释不能嵌套使用

注释

注释（Comments）作用是用来向用户提示或解释某些代码的作用和功能，它可以出现在代码中的任何位置。Python 解释器在执行代码时会忽略注释，不做任何处理。

Python 支持两种类型的注释，分别是单行注释和多行注释。

单行注释

Python中单行注释以井号 # 开头，语法为：# 注释内容 。

Python解释器会忽略#后整行的内容。

说明单行代码

说明单行代码时的单行注释置于代码所在行右侧：

print("HelloWorld")  # 这是说明单行代码的单行注释
1

说明多行代码

说明多行代码时的单行注释置于这些代码首行的上一行：

# 这是说明多行代码的单行注释
print("HelloWorld")
print("This is the first python program")
1
2
3

Tips:

• Pycharm中执行/取消单行注释的快捷键是CTRL+/ ，也可以一次选中多行将其每行变为单行注释。

多行注释

Python中多行注释可以使用三个连续的单引号'''或者三个连续的双引号"""，语法为：

'''
使用三个连续单引号的多行注释
使用三个连续单引号的多行注释
'''

"""
使用三个连续双引号的多行注释
使用三个连续双引号的多行注释
"""
1
2
3
4
5
6
7
8
9

从技术上讲，这种用三引号括起来的多行注释不是真正的注释，而是字符串文字，Python解释器并不会忽略长字符串，也会按照语法解析，只是长字符串没有赋值给任何变量，所以长字符串起不到实际作用而已。

注意事项

1. Python多行注释不支持嵌套使用，虽然两种多行注释混合使用可以嵌套（从技术上讲，这使用的是字符串文字，而不是注释），但是如果必须注释掉已经包含许多其他三重引用注释的代码块，唯一安全的选择是注释掉每行。下面这种写法就是错的（虽然可能IDE不报错）：

   """
   第一层
       """
       第二层
       """
   """
   1
   2
   3
   4
   5
   6

2. 当注释符作为字符串的一部分出现时，就应该看做正常代码的一部分，例如：

   print("#HelloWorld")
   1

   输出的就是#HelloWorld 。但是更值得注意的是，Python中字符串如果以单引号、双引号标识和三引号标识开头，则字符串结尾也必须是对应的标识，都可以作为字符串的开始和结束标志。

   然而当字符串本身包含了单引号时，该字符串只能使用双引号或三双引号引起：

   print("'HelloWorld'")
   print("""'HelloWorld'""")
   1
   2

   输出均为：

   'HelloWorld'
   'HelloWorld'
   1
   2

   当字符串本身包含了双引号时，该字符串只能使用单引号或三单引号引起：

   print('"HelloWorld"')
   print('''"HelloWorld"''')
   1
   2

   输出均为：

   "HelloWorld"
   "HelloWorld"
   1
   2

   当字符串本身包含了单引号和双引号时，该字符串只能使用三单引号引起：

   print(''''HelloWorld"''')
   1

   输出均为：

   'HelloWorld"
   1

   当字符串包含多行时，只能使用三引号：

   print('''I
   Love
   You''')
   print("""I
   Love
   You""")
   1
   2
   3
   4
   5
   6

   输出均为：

   I
   Love
   You
   I
   Love
   You
   1
   2
   3
   4
   5
   6

行与缩进

python最具特色的就是使用缩进和冒号:来表示代码块，不需要使用大括号{} 。

缩进

Python中实现对代码的缩进可以使用空格键或Tab键，缩进的空格数是可变的，但通常是采用4个空格长度作为一个缩进量（即默认情况下一个 Tab 键表示的空格数）。

Python对代码缩进量要求很严格，同一个代码块的语句必须包含相同的缩进空格数。

if True:
    print ("Hello")
    print ("World")
else:
    print ("Hello")
  print ("World")
1
2
3
4
5
6

上述代码由于最后一行缩进量和所属代码块缩进量不一致，会报以下错误：

IndentationError: unindent does not match any outer indentation level
1

Tips：

Pycharm中多行代码向前缩进的快捷键为选中多行后按下Tab ，向后缩进的快捷键为选中多行后按下Shift+Tab 。

空行

函数之间或类的方法之间用空行分隔，表示一段新的代码的开始。类和函数入口之间也用一行空行分隔，以突出函数入口的开始。

空行与代码缩进不同，空行虽然是程序代码的一部分但并不是Python语法的一部分。所以不插入空行Python解释器运行也不会出错。但是空行的作用在于分隔两段不同功能或含义的代码，便于日后代码的维护或重构。

多行语句

如果一行Python语句太长时，可以用反斜杠\ 实现多行语句：

total = a + \
        b + \
        c
1
2
3

在[], {}, 或()中的多行语句，不需要使用反斜杠\：

total = (a +
         b +
         c)
1
2
3

Tips：

PEP 8编码规范更推荐用小括号连接多行语句，而不推荐使用反斜杠\进行连接。

同一行显示多条语句

Python可以在同一行中使用多条语句，语句之间使用分号; 分隔：

print("Hello"); print("World")
1

不过将多行语句写到一行不符合PEP 8代码规范，并不推荐。

代码组

缩进相同的一组语句构成一个代码块，我们称之代码组。

像if、while、def和class这样的复合语句，首行以关键字开始，以冒号:结束，与该行之后的一行或多行代码构成代码组。

我们将首行及后面的代码组称为一个子句(clause)。

if True:
    print ("Hello")
    print ("World")
else:
    print ("Hello")
    print ("World")
1
2
3
4
5
6

上述代码含有两个代码组，两个字句。

PEP 8编码规范

Python采用PEP 8编码规范，官方介绍为：PEP 8

常见的一些编码规范为：

1. 单行注释#后应有一个空格：

   # 单行注释
   1

2. 置于代码右侧的单行注释要距离代码两个空格：

   print("HelloWorld")  # 单行注释
   1

3. 代码的最后一行为空行：

   print("HelloWorld")
   
   1
   2

4. 每个import语句一次只导入一个模块：

   import os
   import sys
   1
   2

5. 在运算符两侧、函数参数之间以及逗号后（逗号前不能有空格），使用空格进行分隔：

   a, b = 0
   c = a + b
   1
   2

6. 不要在行尾添加分号，也不要用分号分隔同一行中的多条语句：

   print("Hello"); print("World")
   1

7. 一般情况下，每行不超过80个字符，如果超过，使用小括号()将多行内容连接起来，而不是用反斜杠\进行连接。

   total = (a +
            b +
            c)
   1
   2
   3