002.[python学习]python编码规范pep8学习——PEP8第二部分

2. 字符串引号

    python中单引号字符串和双引号字符串是相同的，如果字符串中含有单引号或者双引号，可以用另一个引号来避免在字符串中使用反斜线转义。三个引号括起来的字符串也是合法的。

 

3. 表达式和语句中的空白

3.1 括号、中括号、花括号紧跟着不要跟空格；

3.2 逗号、分号、冒号前不要加空格；

3.3 函数名和参数起始左括号间不要加空格；

3.4 索引或切片左中括号前不要加空格；

3.5 不要为了与其他代码对齐而添加多余的空格。

 

4. 注释

 与代码相矛盾的注释不如没有注释，更新代码时保持同步更新注释。

4.1 块注释、行内注释都使用#

4.2 文档字符串使用"""，并且注释结束的"""应单独占一行（文档字符串只有一行时应放在一行中）。

 

5. 命名约定

命名这块python官方库有些凌乱，所以没有个完全一致的约定，下面的命名约定只是目前来说推荐的标准。建议新编写的模块尽量参考这些标准。

首先，命名对用户来说是API的一部分，它应该遵守约定但不要与代码实现冲突。

中文可参考：

http://blog.sae.sina.com.cn/archives/4781

http://www.cnblogs.com/sunada2005/archive/2013/07/11/3183759.html

英文：

http://legacy.python.org/dev/peps/pep-0008/#naming-conventions

 

---

 

编写代码时可以遵守PEP8约定，同样你也可以使用pep8模块来对代码进行检查：

第一步 安装pep8

    linux中使用 sudo pip install pep8命令安装；

    windows中使用python -m pip install pep8安装；

    如果官方源更新速度慢，可以使用豆瓣的源，配置如下：

[global]
trusted-host=pypi.douban.com
index-url=http://pypi.douban.com/simple

    当然你也可以把pep8源码下载下来，使用setup tools安装

第二步 使用pep8对代码做检查

    windows下执行python -m pep8 source_code.py