admin 管理员组文章数量: 1086019
2024年4月13日发(作者:在线apk查看源码)
PCS7 Python编码规范
概述
本文参考自 Python 增进提案仓库 008 号文件的倡议。
原文“PEP 008 《Style Guide for Python Code》”:/dev/peps/pep-0008/
精巧地址:/2OQ8Z3
其中文翻译:/moin/PythonCodingRule
精巧地址:/3HURoL
在这里先简要叙述一下要点。
应用
Python八荣八耻
以动手实践为荣,以只看不练为耻;
以打印日志为荣,以单步跟踪为耻;
以空格缩进为荣,以制表缩进为耻;
以单元测试为荣,以人工测试为耻;
以模块复用为荣,以复制粘贴为耻;
以多态应用为荣,以分支判断为耻;
7
S
C
P
|
范
规
码
编
n
o
h
t
y
P
|
n
o
h
t
y
P
的
爱
可
|
7
4
以Pythonic为荣,以冗余拖沓为耻;
以总结分享为荣,以跪求其解为耻。
这首诗出自于CPyUG:40912:/group/python-cn/browse_thread/
thread/71c74c4e77577365/a4940f98b59bde43
精巧地址:/4jeBor
它非常简明地指出了学习Python的多个注意点。
一致性的建议
愚蠢地使用一致性是无知的妖怪(A Foolish Consistency is the Hobgoblin of Little Minds)。
这里的一致性主要是指一个项目内的一致性和一个模块或函式内的一致性,相对于前者
而言,后者更为重要。但最重要的是知道何时会不一致。当出现不一致时,运用自己的
最佳判断,看看别的例子,然后决定怎样看起来更好。
代码的布局
缩进
建议使用Emacs的Python-mode默认值:4个空格一个缩进层次。对于确实古老的代码,
若不希望产生混乱,可以继续使用8空格的制表符。在Emacs的Python-mode中会自动
发现文件中主要的缩进层次,依此设定缩进参数。如果使用其他的编辑器,如vim、gedit、
ulipad等,积极建议把4个空格作为一个缩进层次。
制表符还是空格
永远不要混用制表符和空格,因为如果混用了,虽然在编辑环境中显示两条语句为同一
缩进层次,但因为制表符和空格的不同会导致Python解释为两个不同的层次。
最流行的Python缩进方式是仅使用空格,其次是仅使用制表符。若一定要混合使用制表
符和空格,可以将其转换成仅使用空格。如在Emacs中,选中整个缓冲区,按ESC+X键
去除制表符。或者在调用Python命令行解释器时使用-t选项,可对代码中不合法的混合
制表符和空格发出警告,使用-tt时警告将变成错误,这些选项是被高度推荐的。但是强
烈推荐仅使用空格而不是制表符。
行的最大长度
有许多设备被限制为每行80字符,窗口也限制为80个字符,因此,建议将所有行限制
在最大79字符(Emacs准确地将行限制为长80字符)。
版权声明:本文标题:python编程规范 内容由网友自发贡献,该文观点仅代表作者本人, 转载请联系作者并注明出处:http://www.roclinux.cn/p/1712962823a614507.html, 本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容,一经查实,本站将立刻删除。
发表评论