猿视野|Python-不得不知的PEP8代码规范
常见的注意点：
1、每一级缩进使用4个空格 。
2、续行应该与其包裹元素对齐 ， 要么使用圆括号、方括号和花括号内的隐式行连接来垂直对齐 ， 要么使用挂行缩进对齐3 。 当使用挂行缩进时 ， 应该考虑到第一行不应该有参数 ， 以及使用缩进以区分自己是续行 。
3、建议写法
文章图片
【猿视野|Python-不得不知的PEP8代码规范】4、不建议写法：
文章图片
行的最大长度：
1、所有行限制的最大字符数为79 。
2、没有结构化限制的大块文本（文档字符或者注释） ， 每行的最大字符数限制在72 。 空行：
1、顶层函数和类的定义 ， 前后用两个空行隔开 。
2、类里的方法定义用一个空行隔开 。 imports导入：
1、多个模块分行导入 ， 例如：
文章图片
2、导入总是位于文件的顶部 ， 在模块注释和文档字符串之后 ， 在模块的全局变量与常量之前 。
3、导入应该按照标准库、相关第三方库、自定义库的顺序分组 ， 每组之间用空行隔开 。
4、推荐使用绝对路径导入 ， 如果导入系统没有正确的配置（比如包里的一个目录在sys.path里的路径后） ， 使用绝对路径会更加可读并且性能更好（至少能提供更好的错误信息） 。 BlockComments块注释
1、块注释通常适用于跟随它们的某些（或全部）代码 ， 并缩进到与代码相同的级别 。 块注释的每一行开头使用一个#和一个空格（除非块注释内部缩进文本） 。
2、块注释内部的段落通过只有一个#的空行分隔 。 InlineComments行内注释
1、有节制地使用行内注释 。
2、行内注释是与代码语句同行的注释 。 行内注释和代码至少要有两个空格分隔 。 注释由#和一个空格开始 。 DocumentationStrings文档字符串
1、要为所有的公共模块 ， 函数 ， 类以及方法编写文档说明 。
2、非公共的方法没有必要 ， 但是应该有一个描述方法具体作用的注释 。 这个注释应该在def那一行之后 。
3、PEP257描述了写出好的文档说明相关的约定 。 特别需要注意的是 ， 多行文档说明使用的结尾三引号应该自成一行 ， 例如：
文章图片
约定俗成的命名：应避免的名字：
1、永远不要使用字母‘l’（小写的L） ， ‘O’（大写的O） ， 或者‘I’（大写的I）作为单字符变量名 。
2、在有些字体里 ， 这些字符无法和数字0和1区分 ， 如果想用‘l’ ， 用‘L’代替 。 ClassNames类名：
1、类名一般使用首字母大写的约定 。
2、在接口被文档化并且主要被用于调用的情况下 ， 可以使用函数的命名风格代替 。
3、注意 ， 对于内置的变量命名有一个单独的约定：大部分内置变量是单个单词（或者两个单词连接在一起） ， 首字母大写的命名法只用于异常名或者内部的常量 。 FunctionNames函数名
1、函数名应该小写 ， 如果想提高可读性可以用下划线分隔 。
2、大小写混合仅在为了兼容原来主要以大小写混合风格的情况下使用（比如threading.py） ， 保持向后兼容性 。 Functionandmethodarguments函数和方法参数
1、始终要将self作为实例方法的的第一个参数 。
2、始终要将cls作为类静态方法的第一个参数 。
3、如果函数的参数名和已有的关键词冲突 ， 在最后加单一下划线比缩写或随意拼写更好 。 因此class_比clss更好 。 （也许最好用同义词来避免这种冲突）ProgrammingRecommendations编程建议
推荐阅读
- 化石|最不幸古生物：雌雄繁殖一半成琥珀，姿势不得不保持4100万年
- 卫星|以前用的“卫星锅”，它到底能看到些什么？怪不得要禁止使用
- 林新伟新思维|赚走美国人几百亿，连美军也不得不用，第二个华为横空出世
- ZAKER|工信部出手！以后这些人或不得给你打电话了
- 北京商报|工信部旧规新提的落地难在哪，谢绝来电！未经用户同意不得发送商业短消
- 闲搞机|α民间拆机，主板集成度超高！网友：怪不得无法量产，小米MIX
- 黄鼠狼|为啥老一辈说“黄大仙”杀不得？科学结果表明：原来真的杀不得！
- 产业气象站|是交不起电费？专家：真相往往让人哭笑不得，联通偷偷关闭信号塔
- 华为|舍不得713亿套不住芯片！白宫也没想到，华为的胜利来得如此快
- 筱娱视野|专家：人类帮不了它们，全球气候变暖加剧！全球一半珊瑚礁已死亡