不遵守编程规范的程序员,简直就是耍流氓,python为了抵制流氓,特意把核心规范加到了运行环境中。
但也有部分需要靠个人自觉遵守的。
1. 分号:不要在行尾加分号, 也不要用分号将两条命令放在同一行;
2. 字符串: 即使参数都是字符串, 使用%操作符或者格式化方法格式化字符串. 不过也不能一概而论, 你需要在+和%之间好好判定;
3. 文件和sockets:在文件和sockets结束时, 显式的关闭它;
4. TODO注释:为临时代码使用TODO注释, 它是一种短期解决方案. 不算完美, 但够好了;
5. 导入格式: 每个导入应该独占一行;
6. 命名
(1)应该避免的名称
- 单字符名称, 除了计数器和迭代器;
- 包/模块名中的连字符(-);
- 双下划线开头并结尾的名称(Python保留, 例如__init__).
(2) 命名约定
- 所谓”内部(Internal)”表示仅模块内可用, 或者, 在类内是保护或私有的;
- 用单下划线(_)开头表示模块变量或函数是protected的(使用from module import *时不会包含);
- 用双下划线(__)开头的实例变量或方法表示类内私有;
- 将相关的类和顶级函数放在同一个模块里. 不像Java, 没必要限制一个类一个模块;
- 对类名使用大写字母开头的单词(如CapWords, 即Pascal风格), 但是模块名应该用小写加下划线的方式(如lower_with_under.py). 尽管已经有很多现存的模块使用类似于CapWords.py这样的命名, 但现在已经不鼓励这样做, 因为如果模块名碰巧和类名一致, 这会让人困扰。
此文转载文,著作权归作者所有,如有侵权联系小编删除!
原文地址:https://www.tuicool.com/articles/b2uquqF