Python学习笔记

Python的编码规范

1.代码编码格式

一般来说，声明编码格式在脚本中是必需的。

国际惯例，文件编码和 Python 编码格式全部为 utf-8 。例如：在 Python 代码的开头，要统⼀加上如下代码：

# -- coding: utf-8 --

如果Python源码文件没有声明编码格式，Python解释器会默认使用ASCII编码。但出现非ASCII编码的字符，Python解释器就会报错，因此非 ASCII 字符的字符串，请需添加u前缀。

若出现 Python编码问题，可按照以下操作尝试解决：

import sys

reload(sys)

sys.setdefaultencoding('utf-8')

2.分号：不要在行尾加分号，也不要用分号将两条命令放在同一行。

3.行的最大长度

每行不超过80给字符，除了要：长的导入模块语句或者是注释里的URL。

不要用反斜杠连接行，可以用圆括号来实现隐式行连接

隐式的行拼接可以带有注释。后续行的缩进不影响程序结构。后续行也允许为空白行。

4.缩进规则

• Python 采用代码缩进和冒号（ : ）来区分代码块之间的层次。
• 在 Python 中，对于类定义、函数定义、流程控制语句、异常处理语句等，行尾的冒号和下一行的缩进，表示下一个代码块的开始，而缩进的结束则表示此代码块的结束。
• Python 中实现对代码的缩进，可以使用空格或者 Tab 键实现。但无论是手动敲空格，还是使用 Tab 键，通常情况下都是采用 4 个空格长度作为一个缩进量（默认情况下，一个 Tab 键就表示 4 个空格）。
• 对于 Python 缩进规则，初学者可以这样理解，Python 要求属于同一作用域中的各行代码，它们的缩进量必须一致，但具体缩进量为多少，并不做硬性规定。

建议使用 Emacs 的 Python-mode 默认值：4 个空格一个缩进层次。不要用tab，也不要tab和空格混用

5.注释

Python中用#进行注释，#号后面要空一格。

为了提高可读性，注释和代码隔开一定的距离，注释应该至少离开代码2个空格，块注释后面最好多留几行空白再写代码。

当代码更改时，优先更新对应的注释。

如果一个注释是一个短语或者句子，它的第一个单词应该大写，除非它是以小写字母开头的标识符（永远不要改变标识符的大小写！）。

如果注释很短，结尾的句号可以省略。块注释一般由完整句子的一个或多个段落组成，并且每句话结束有个句号。

在句尾结束的时候应该使用两个空格。

Python注释分为三种：行注释，块注释，文档注释

行注释：解释自己做什么，不是对代码本身注释。要有节制的使用，行内注释是代码语句同行的注释；行内注释和代码至少要有两个空格分隔；注释#和一个空格分开

块注释：跟随适用于他们的某些代码 ，并缩进到与代码相同的级别；每行开头使用一个#和一个空格;块注释的段落通常只有一个#的空行分隔

文档注释：腰围所有公共模块，函数，类和方法编写文档进行说明；非公共的方法没有必要，但要有一个描述方法具体作用的注释，且在def行之后；多行文档注释使用的结尾三引号是自成一行。