1.6　Python代码编写基本规范

为了让Python解释器能够准确地理解和执行代码，在编写代码时我们还需要遵守一些基本规范，其中比较重要的就是缩进和注释的规范。下面分别进行讲解。

1.6.1　缩进

缩进是Python最重要的代码编写规范之一，类似于Word文档中的首行缩进。如果缩进不规范，代码在运行时就会报错。先来看下面的代码：

1  x = 10
2  if x > 0:
3      print('正数')
4  else:
5      print('负数')

第2～5行代码是之后会讲到的if语句，它和for语句、while语句一样，通过冒号和缩进来区分代码块之间的层级关系。因此，第2行和第4行代码末尾必须有冒号，第3行和第5行代码开头必须有缩进，否则运行时会报错。

Python对缩进的要求非常严格，同一个层级的代码块，其缩进量必须一样。但Python并没有硬性规定具体的缩进量，默认以4个空格（即按4次空格键）作为缩进的基本单位。

在PyCharm中，可以用更快捷的方法来处理缩进：按1次【Tab】键可输入1个缩进（即4个空格），按快捷键【Shift+Tab】可减小缩进量。如果要批量调整多行代码的缩进量，可以选中要调整的多行代码，按【Tab】键统一增加缩进量，按快捷键【Shift+Tab】统一减小缩进量。

需要注意的是，按【Tab】键实际上输入的是制表符，只是PyCharm会将其自动转换为4个空格。而有些文本编辑器并不会自动转换，就容易出现缩进中混用空格和制表符的情况，从而导致运行错误。这也是本书推荐使用PyCharm作为代码编辑器的原因之一，它有许多贴心的功能，可以帮助我们避免一些低级错误，从而减少代码调试的工作量。

此外，缩进不正确有时并不会导致运行错误，但是会导致Python解释器不能正确地理解代码块之间的层级关系，从而得不到我们想要的运行结果。因此，读者在阅读和编写代码时一定要注意其中的缩进。

1.6.2　注释

注释是对代码的解释和说明，Python代码的注释分为单行注释和多行注释两种。

1. 单行注释

单行注释以“#”号开头。单行注释可放在被注释代码的后面，也可作为单独的一行放在被注释代码的上方。放在被注释代码后的单行注释的演示代码如下：

1  a = 1
2  b = 2
3  if a == b:  # 注意表达式里是两个等号
4      print('a和b相等')
5  else:
6      print('a和b不相等')

运行结果如下：

1  a和b不相等

第3行代码中“#”号后的内容就是注释内容，它不参与程序的运行。上述代码中的注释也可以修改为放在被注释代码的上方，演示代码如下：

1  a = 1
2  b = 2
3  # 注意表达式里是两个等号
4  if a == b:
5      print('a和b相等')
6  else:
7      print('a和b不相等')

为了增强代码的可读性，本书建议在编写单行注释时遵循以下规范：

●单行注释放在被注释代码上方时，在“#”号之后先输入一个空格，再输入注释内容；

●单行注释放在被注释代码后面时，“#”号和代码之间至少要有两个空格，“#”号与注释内容之间也要有一个空格。

2. 多行注释

当注释内容较多，放在一行中不便于阅读时，可使用多行注释。在Python中，使用三引号（3个连续的单引号或双引号）创建多行注释。

用单引号形式的三引号创建多行注释的演示代码如下：

1  '''
2  这是多行注释，用3个单引号
3  这是多行注释，用3个单引号
4  这是多行注释，用3个单引号
5  '''
6  print('Hello, Python!')

第1～5行代码就是注释，不参与运行，所以运行结果如下：

1  Hello, Python!

用双引号形式的三引号创建多行注释的演示代码如下：

1  """
2  这是多行注释，用3个双引号
3  这是多行注释，用3个双引号
4  这是多行注释，用3个双引号
5  """
6  print('Hello, Python!')

第1～5行代码也是注释，不参与运行，所以运行结果如下：

1  Hello, Python!

注释还有一个作用：在调试程序时，如果有暂时不需要运行的代码，不必将其删除，可以先将其转换为注释，等调试结束后再取消注释，这样能减少代码输入的工作量。 0ulVN/gtsPxO9Foxm0ZKTgZ35Vc1re1lVOOdK2I5ECePbjWnH0/x3j/YNfayczWh