1 / 18
文档名称:

python开发规范.doc

格式:doc   大小:101KB   页数:18页
下载后只包含 1 个 DOC 格式的文档,没有任何的图纸或源代码,查看文件列表

如果您已付费下载过本站文档,您可以点这里二次下载

分享

预览

python开发规范.doc

上传人:xnzct26 2020/3/14 文件大小:101 KB

下载得到文件列表

python开发规范.doc

相关文档

文档介绍

文档介绍:Python开发规范总则概况:Python风格规范,包含了部分Google风格规范和PEP8规范。包括Django项目目录结构的一些规范,为适应我们实际需求,提高开发中代码更加可观性、易读性拟定的规范。,首字母保持小写,尽量不要用下划线(除非多个单词,且数量不多的情况)#正确的模块名importdecoderimporthtml_parser#不推荐的模块名importDecoder类名使用驼峰(CamelCase)命名风格,首字母大写,私有类可用一个下划线开头classFarm():passclassAnimalFarm(Farm):passclass_PrivateFarm(Farm):,,如有多个单词,用下划线隔开defrun():passdefrun_with_env():pass私有函数在函数前加一个下划线_classPerson():def_private_func():,嵌套层次不宜过深;函数申明应做到合理、简单、易于使用,函数名应能正确反映函数大体功能,参数设计应简洁明了,参数个数不宜过多;函数参数设计应考虑向下兼容;一个函数只做一件事,尽量保证函数语句粒度的一致性;;避免使用容易引起混淆的名称,变量名应与所解决的问题域一致;不要害怕过长的变量名;常量使用以下划线分隔的大写命名MAX_OVERFLOW=100ClassFooBar:deffoo_bar(self,print_):print(print_)变量名尽量小写,如有多个单词,用下划线隔开if__name__=='__main__':count=0school_name=''常量采用全大写,如有多个单词,使用下划线隔开MAX_CLIENT=100MAX_CONNECTION=1000CONNECTION_TIMEOUT=”内部(Internal)”表示仅模块内可用,或者,(_)开头表示模块变量或函数是protected的(使用import*from时不会包含).(__),(如CapWords,即Pascal风格),但是模块名应该用小写加下划线的方式().(-)而不使用下划线(_)(如__init__),文件一律使用UTF-8编码如无特殊情况,文件头部必须加入#--coding:utf-8--、、行宽每行代码尽量不超过80个字符(在特殊情况下可以略微超过80,但最长不得超过120),中括号和花括号中的行隐式的连接起来,,,你应该要么垂直对齐换行的元素,或者使用4空格的悬挂式缩进(这时第一行不应该有参数):理由:这在查看side-by-,自然语言使用双引号,机器标示使用单引号,因此代码里多数应该使用单引号自然语言使用双引号“…”例如错误信息;很多情况还是unicode,使用u”你好世界”机器标识使用单引号‘…’例如dict里的key正则表达式使用原生的双引号r”…”文档字符串(docstring)使用三个双引号“”“……”“”;classA:def__init__(self):passdefhello(self):passdefmain():pass```可以使用多个空行分隔多组相关的函数函数中可以使用空行分隔出逻辑相关的代码类成员函数之间空一行;正确的写法i=i+1submitted+=1x=x*2-1hypot2=x*x+y*yc=(a+b)*(a-b)不推荐的写法i=i+1submitted+=1x=x*2-1hypot2=x*x+y*yc=(a+b)*(a-b)函数的参数列表中,,plex(real,imag):plex(real,imag):pass函数的参数列表中,plex(real,im