- 代码编排:缩进4个空格,行长80,空行(函数间,函数内,文件结尾)
- import: import顺序;单行不要import多个库;模块内用不到的不要去import。空格
- 引入外来算法或者配置时须在注释中添加源连接、标明出处
- 函数和类尽可能添加
_doc_
- 命名
■包名、模块名、函数名、方法名全部使用小写,单词间用下划线连接
■类名、异常名使用CapWords的方式,异常名结尾加Error 或Wraning 后缀
■全局变量尽量使用大写,一组同类型的全局变量要加上统一 前缀 - 常量全部使用大写,单词用下划线连接
- 语意明确、直白
- 一个函数只做一 件事情,并把这件事做好,大的功能用小函数之间灵活组合来完成(《Unix编程艺术》)。函数名必须有动词,最好是do_something 的句式,或者somebody. do. something 句式
- 自定义的变量名、函数名不要与标准库中的名字冲突