摘要:
Python库的命名规范很乱,从来没能做到完全一致。但是目前有一些推荐的命名标准。新的模块和包(包括第三方框架)应该用这套标准,但当一个已有库采用了不同的风格,推荐保持内部一致性。 最重要的原则 那些暴露给用户的API接口的命名,应该遵循反映使用场景而不是实现的原则。 描述:命名分格 有许多不同的命 阅读全文
摘要:
与代码相矛盾的注释比没有注释还糟,当代码更改时,优先更新对应的注释! 注释应该是完整的句子。如果一个注释是一个短语或句子,它的第一个单词应该大写,除非它是以小写字母开头的标识符(永远不要改变标识符的大小写!)。 如果注释很短,结尾的句号可以省略。块注释一般由完整句子的一个或多个段落组成,并且每句话结 阅读全文
摘要:
不能忍受的事情 在下列情况下,避免使用无关的空格: 紧跟在小括号,中括号或者大括号后。 紧贴在逗号、分号或者冒号之前。 然而,冒号在切片中就像二元运算符,在两边应该有相同数量的空格(把它当做优先级最低的操作符)。在扩展的切片操作中,所有的冒号必须有相同的间距。例外情况:当一个切片参数被省略时,空格就 阅读全文
摘要:
缩减 每一级缩减使用4个空格 续行应该与其包裹元素对其, 1. 使用圆括号、方括号和花括号内的隐式行连接来垂直对其。 2. 使用挂式缩进对其。当使用挂式缩进时,应该考虑到第一行不应该有参数,以及使用缩进以区分自己是续行。 不推荐: 4个空格的规则对于续行是可选的。 可选: 当if语句的条件部分长到需 阅读全文