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字符)。


本文标签: 使用 空格 制表符