【Python入门】01 Python注释、行与缩进及PEP 8编码规范

Lum0s!

已于 2023-08-19 20:27:27 修改

阅读量1k

点赞数

分类专栏： Python从0到1 文章标签： python 开发语言

于 2022-07-30 23:20:22 首次发布

本文链接：https://blog.csdn.net/m0_59751822/article/details/126079259

版权

Python从0到1 专栏收录该内容

1 篇文章 0 订阅

订阅专栏

01 Python注释、行与缩进及PEP 8编码规范

注释
行与缩进
PEP 8编码规范

注释

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

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

单行注释

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

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

说明单行代码

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

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

说明多行代码

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

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

Tips:

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

多行注释

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

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

"""
使用三个连续双引号的多行注释
使用三个连续双引号的多行注释
"""

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

注意事项

Python多行注释不支持嵌套使用，虽然两种多行注释混合使用可以嵌套（从技术上讲，这使用的是字符串文字，而不是注释），但是如果必须注释掉已经包含许多其他三重引用注释的代码块，唯一安全的选择是注释掉每行。下面这种写法就是错的（虽然可能IDE不报错）：
```
"""
第一层
    """
    第二层
    """
"""
```
当注释符作为字符串的一部分出现时，就应该看做正常代码的一部分，例如：
```
print("#HelloWorld")
```
输出的就是#HelloWorld 。但是更值得注意的是，Python中字符串如果以单引号、双引号标识和三引号标识开头，则字符串结尾也必须是对应的标识，都可以作为字符串的开始和结束标志。

然而当字符串本身包含了单引号时，该字符串只能使用双引号或三双引号引起：
```
print("'HelloWorld'")
print("""'HelloWorld'""")
```
输出均为：
```
'HelloWorld'
'HelloWorld'
```
当字符串本身包含了双引号时，该字符串只能使用单引号或三单引号引起：
```
print('"HelloWorld"')
print('''"HelloWorld"''')
```
输出均为：
```
"HelloWorld"
"HelloWorld"
```
当字符串本身包含了单引号和双引号时，该字符串只能使用三单引号引起：
```
print(''''HelloWorld"''')
```
输出均为：
```
'HelloWorld"
```
当字符串包含多行时，只能使用三引号：
```
print('''I
Love
You''')
print("""I
Love
You""")
```
输出均为：
```
I
Love
You
I
Love
You
```

行与缩进

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

缩进

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

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

if True:
    print ("Hello")
    print ("World")
else:
    print ("Hello")
  print ("World")

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

IndentationError: unindent does not match any outer indentation level

Tips：

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

空行

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

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

多行语句

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

total = a + \
        b + \
        c

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

total = (a +
         b +
         c)

Tips：

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

同一行显示多条语句

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

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

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

代码组

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

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

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

if True:
    print ("Hello")
    print ("World")
else:
    print ("Hello")
    print ("World")

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

PEP 8编码规范

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

常见的一些编码规范为：

单行注释#后应有一个空格：
```
# 单行注释
```
置于代码右侧的单行注释要距离代码两个空格：
```
print("HelloWorld")  # 单行注释
```
代码的最后一行为空行：
```
print("HelloWorld")
```
每个import语句一次只导入一个模块：
```
import os
import sys
```
在运算符两侧、函数参数之间以及逗号后（逗号前不能有空格），使用空格进行分隔：
```
a, b = 0
c = a + b
```
不要在行尾添加分号，也不要用分号分隔同一行中的多条语句：
```
print("Hello"); print("World")
```
一般情况下，每行不超过80个字符，如果超过，使用小括号()将多行内容连接起来，而不是用反斜杠\进行连接。
```
total = (a +
         b +
         c)
```