Skip to content

LingChenBill/python_first_introduce

Repository files navigation

Python:编码风格

对于Python,PEP 8 已经成为大多数项目所遵循的风格指南;
它促进了一种非常易读且令人赏心悦目的编码风格。
每个Python开发人员都应该在某个时候阅读它;以下是为你提取的最重要的几个要点:

1)使用4个空格缩进,不要使用制表符。
4个空格是一个在小缩进(允许更大的嵌套深度)和大缩进(更容易阅读)的一种很好的折中方案。
制表符会引入混乱,最好不要使用它。
换行,使一行不超过79个字符。
这有助于使用小型显示器的用户,并且可以在较大的显示器上并排放置多个代码文件。

2)使用空行分隔函数和类,以及函数内的较大的代码块。
如果可能,把注释放到单独的一行。

3)使用文档字符串。
在运算符前后和逗号后使用空格,但不能直接在括号内使用: a = f(1, 2) + g(3, 4)。

4)以一致的规则为你的类和函数命名;
按照惯例应使用 UpperCamelCase 来命名类,
而以 lowercase_with_underscores 来命名函数和方法。
始终应使用 self 来命名第一个方法参数 (有关类和方法的更多信息请参阅 初探类)。

5)如果你的代码旨在用于国际环境,请不要使用花哨的编码。
Python 默认的 UTF-8 或者纯 ASCII 在任何情况下都能有最好的表现。
同样,哪怕只有很小的可能,遇到说不同语言的人阅读或维护代码,也不要在标识符中使用非ASCII字符。

About

First python programs

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages