编码规范的意义_我的 Python 编码规范

通常需要进行编码声明，如果源代码文件没有声明编码格式，解释器会默认使用 ASCII 编码，一旦源代码文件包含非 ASCII 字符，解释器就会报错。以 UTF-8 为例，下面两种编码声明均符合规则。

# -*- coding: utf-8 -*-

# coding = utf-8

我一直使用UTF-8编码格式，并且比较喜欢第一种声明方法。

在各个平台上，编码格式声明必须在文件的第一行。在Linux平台上，编码格式声明通常在文件的第二行，第一行是解释器的路径声明。

#!/usr/bin/env python# -*- coding: utf-8 -*-

缩进

始终使用 4 个空格进行缩进。切勿使用制表符，也不要混合使用制表符和空格。对于行延续，我通常使用 4 个空格悬挂缩进。例如：

var_dict = {    'name': 'xufive',    'mail': 'xufive@sdysit.com'}

引号

笔记

# 符号后有一个空格，段落之间用空行分隔（# 符号也是必需的）：

    # 块注释    # 块注释    #    # 块注释    # 块注释

行内注释与语句之间至少有两个空格隔开：

age += 1  # 年龄增加一岁

对于比较重要的注释部分，可以使用多个等号来分隔，这样可以更加醒目，凸显其重要性：

    server= gogame(room, options)
    # =====================================    # 请勿在此处倾倒垃圾!!!    # =====================================
    if __name__ == '__main__':        server.run()

空行

空间

文档字符串

文档字符串是包、模块、类或函数中的第一个语句。这些字符串会自动从对象成员中提取并由 pydoc 使用。文档字符串括在三个双引号 (""") 中。如果文档字符串无法放在一行中，则第一行必须以句号、问号或感叹号结尾，后跟一个空行，并且结尾的三个双引号必须位于单独的一行中。

导入模块

导入应始终位于文件顶部，在模块注释和文档字符串之后，在模块全局变量和常量之前。导入应按从最通用到最不通用的顺序分组，各组之间留一个空行：

标准库导入

导入第三方库

应用程序特定导入

应避免使用以下导入方法：

from math import *

命名约定

推荐阅读：
60个Chrome神器插件大收集：助你快速成为老司机，一键分析网站技术栈
jieba，宇宙最强Python分词工具使用指南
PC客户端爬虫，这样设置代理就对了
超强算法：一张图让二次元妹纸活起来！


好文和朋友一起看~