|
为了让自己编写的python更美更规范,特地整理如下:
模块文件结构:
================
1.注释,如
#!/usr/bin/env python
# -*- coding: iso-8859-1 -*-
2.模块文档字符,用三引号
3. import 语句
4. 全局变两声名
5. 类/函数定义
6. 测试函数
====================
缩进:
四个空格,使用编辑器自动缩进功能的请确保不以tab缩进
空行:
在上述文件结构中每个模块之间空一行;在控制结构(尤其是复杂的)前后各留一个空行
续行:
定义字符串时尽量避免用 ' \ ' 来表示续行,改用三引号;函数调用时以逗号来进行分行
引号:
强烈建议用三引号来定义文档化字符串。普通字符串中没有特殊要求,只要嵌套正确即可
逗号:
在定义元组并赋初值的时侯, 建议以逗号结尾,如下例:
t = (1,2,)
变量名:
用有意义的变量名,并且避免普通变量以下划线和双下划线开头
函数参数名称:
成员函数第一个参数请命名为self
测试函数:
请为自定义模块添加测试函数,参考下例:
if __name__ == 'main':
......
发现一个好地方:
http://man.chinaunix.net/develop/python/python_howto/python_howto_program.htm
权威指南(编程风格):
http://www.python.org/dev/peps/pep-0008/ |
|
|