这篇文章主要讲解了“Python编码规范知识点实例分析”，文中的讲解内容简单清晰，易于学习与理解，下面请大家跟着小编的思路慢慢深入，一起来研究和学习“Python编码规范知识点实例分析”吧！
沙河ssl适用于网站、小程序/APP、API接口等需要进行数据传输应用场景，ssl证书未来市场广阔！成为创新互联的ssl证书销售渠道，可以享受市场价格4-6折优惠！如果有意向欢迎电话联系或者加微信：13518219792（备注：SSL证书合作）期待与您的合作！
1 代码编码格式
# -- coding: utf-8 --
import sys
reload(sys)
sys.setdefaultencoding('utf-8')2 分号
不要在行尾加分号，也不要用分号将两条命令放在同一行。
3 行的最大长度
每行不超过80个字符
以下情况除外：
长的导入模块语句
注释里的URL
不要使用反斜杠连接行。
Python会将 圆括号, 中括号和花括号中的行隐式的连接起来 。
圆括号、方括号或花括号以内的表达式允许分成多个物理行，无需使用反斜杠。例如：
month_names = ['Januari', 'Februari', 'Maart', # These are the
'April', 'Mei', 'Juni', # Dutch names
'Juli', 'Augustus', 'September', # for the months
'Oktober', 'November', 'December'] # of the year
隐式的行拼接可以带有注释。后续行的缩进不影响程序结构。后续行也允许为空白行。
如果需要，可以在表达式外围增加一对额外的圆括号。
如果一个文本字符串在一行放不下, 可以使用圆括号来实现隐式行连接
x = ('这是一个非常长非常长非常长非常长 '
'非常长非常长非常长非常长非常长非常长的字符串')4 缩进规则
Python 采用代码缩进和冒号（ : ）来区分代码块之间的层次。
在 Python 中，对于类定义、函数定义、流程控制语句、异常处理语句等，行尾的冒号和下一行的缩进，表示下一个代码块的开始，而缩进的结束则表示此代码块的结束。
Python 中实现对代码的缩进，可以使用空格或者 Tab 键实现。但无论是手动敲空格，还是使用 Tab 键，通常情况下都是采用 4 个空格长度作为一个缩进量（默认情况下，一个 Tab 键就表示 4 个空格）。
对于 Python 缩进规则，初学者可以这样理解，Python 要求属于同一作用域中的各行代码，它们的缩进量必须一致，但具体缩进量为多少，并不做硬性规定。
建议使用 Emacs 的 Python-mode 默认值：4 个空格一个缩进层次。不要用tab，也不要tab和空格混用
正确示例代码:
if a==0:
print("正确") # 缩进4个空白占位
else: # 与if对齐
print("错误") # 缩进4个空白占位
或者
# 4 个空格缩进，第一行不需要
foo = long_function_name(
var_one, var_two, var_three,
var_four)错误示例代码:
if a==0:
print("正确")
else:
print("错误")
print("end") # 错误的是这行代码前面加了一个空格
或者
# 2 个空格是禁止的
foo = long_function_name(
var_one, var_two, var_three,
var_four)5 注释
Python中使用 # 进行注释，# 号后面要空一格。
最需要写注释的是代码中那些技巧性的部分：对于复杂的操作，应该在其操作开始前写上若干行注释.；对于不是一目了然的代码，应在其行尾添加注释。
为了提高可读性，注释和代码隔开一定的距离，注释应该至少离开代码2个空格，块注释后面最好多留几行空白再写代码。
当代码更改时，优先更新对应的注释。
如果一个注释是一个短语或者句子，它的第一个单词应该大写，除非它是以小写字母开头的标识符（永远不要改变标识符的大小写！）。
如果注释很短，结尾的句号可以省略。块注释一般由完整句子的一个或多个段落组成，并且每句话结束有个句号。
在句尾结束的时候应该使用两个空格。
Python中有三种形式的注释：行注释、块注释、文档注释
行注释：注释应解释自己做了什么，而不是对代码本身的解释
有节制地使用行内注释
行内注释是与代码语句同行的注释
行内注释和代码至少要有两个空格分隔
注释由#和一个空格开始。
n = input()
m = input()
t = n / 2 # t是n的一半
# 循环，条件为t*m/n 小于n
while (t * m / (n + 1) < n):
t = 0.5 * m + n / 2 # 重新计算t值
print(t)
块注释：
def FuncName(parameter1,parameter2):
"""
描述函数要做的事情
:param parameter1: 参数一描述(类型、用途等)
:param parameter2: 参数二描述
:return: 返回值描述
"""
# We use a weighted dictionary search to find out where i is in
# the array. We extrapolate position based on the largest num
# in the array and the array size and then do binary search to
# get the exact number.
if i & (i-1) == 0: # true if i is a power of 2
文档注释：
class SampleClass(object):
"""Summary of class here.
Longer class information....
Longer class information....
Attributes:
likes_spam: A boolean indicating if we like SPAM or not.
eggs: An integer count of the eggs we have laid.
"""
def __init__(self, likes_spam=False):
"""Inits SampleClass with blah."""
self.likes_spam = likes_spam
self.eggs = 0
def public_method(self):
"""Performs operation blah."""
6 空行
class Class01:
pass
class Class02:
def function_01(self):
pass
def function_02(self):
pass
使用必要的空行可以增加代码的可读性，通常在顶级定义（如函数或类的定义）之间空两行，而方法定义之间空一行，另外在用于分隔某些功能的位置也可以空一行。
7 制表符还是空格
空格使用规则：
在二元运算符两边各空一格，比如赋值(=)、比较(==, <, >, !=, <>, <=, >=, in, not in, is, is not), 布尔(and, or, not)，算术操作符两边的空格可灵活使用，但两侧务必要保持一致
不要在逗号、分号、冒号前面加空格，但应该在它们后面加（除非在行尾）
函数的参数列表中，逗号之后要有空格
函数的参数列表中，默认值等号两边不要添加空格
左括号之后，右括号之前不要加添加空格
参数列表， 索引或切片的左括号前不应加空格
当'='用于指示关键字参数或默认参数值时，不要在其两侧使用空格
正确示例代码:
spam(ham[1], {eggs: 2}, [])
if x == 4:
print x, y
x, y = y, x
dict['key'] = list[index]
def complex(real, imag=0.0): return magic(r=real, i=imag)错误示例代码:
spam( ham[ 1 ] , { eggs: 2 } , [ ] )
if x == 4 :
print x , y
x , y = y , x
dict ['key'] = list [index]
def complex(real, imag = 0.0): return magic(r = real, i = imag)8 命名规范
模块名命名
# 正确
import decoder
import html_parser
# 不推荐
import Decoder
变量命名
count = 0
this_is_var = 0
常量或者全局变量命名
全部大写，如有多个单词，用下划线隔开
全⼤写+下划线式驼峰
MAX_CLIENT = 100
函数命名
def run():
pass
def run_with_env():
pass
class Person():
def _private_func():
pass
类命名
类名使用驼峰(CamelCase)命名风格，首字母大写，私有类可用一个下划线开头。
在接口被文档化并且主要被用于调用的情况下，可以使用函数的命名风格代替。
对于内置的变量命名有一个单独的约定：大部分内置变量是单个单词（或者两个单词连接在一起），首字母大写的命名法只用于异常名或者内部的常量。
class Farm():
pass
class AnimalFarm(Farm):
pass
class _PrivateFarm(Farm):
pass
类里面函数和方法参数
特别注意：
不要中英文混编
不要有a、b、c这种没有意义的命名
不要怕名字长就随便缩写，比如person_info 缩写成pi
不要用大小写区分变量类型，比如a是int类型，A是String类型
不要使用容易引起混淆的变量名
bool变量⼀般加上前缀 is_ 如：is_success
变量名不要用系统关键字，如 dir type str等等
以下用下画线作前导或结尾的特殊形式是被公认的：
_single_leading_underscore（以一个下画线作前导）：例如，“from M import *”不会导入以下画线开头的对象。
single_trailing_underscore_（以一个下画线结尾）：用于避免与 Python 关键词的冲突，例如“Tkinter.Toplevel(master, class_='ClassName')”。
__double_leading_underscore （双下画线）：从 Python 1.4 起为类私有名。
__double_leading_and_trailing_underscore__：特殊的（magic） 对象或属性，存在于
用户控制的（user-controlled）名字空间，例如：__init__、__import__ 或 __file__。
9 引号用法规则
字符串引号规则：
正确使用示例：
Tim('Why are you hiding your eyes?')
Bob("I'm scared of lint errors.")
Juy('"Good!" thought a happy Python reviewer.')10 模块导入规则
导入应该放在文件顶部，位于模块注释和文档字符串之后，模块全局变量和常量之前。
导入应该按照从最通用到最不通用的顺序分组：标准库导入、第三方库导入、应用程序指定导入，分组之间空一行。
模块名称要短，使用小写，并避免使用特殊符号， 比如点和问号。
尽量保持模块名简单，以无需分开单词最佳（不推荐在两个单词之间使用下划线）。
每个导入应该独占一行。
正确使用例子：
import os
import numpy
import sys
from types import StringType, ListType
错误使用例子：
import os, numpy, sys
from MyClass import MyClass
from foo.bar.YourClass import YourClass
模块导入建议
| 示例 | 评价 | | from modu import * | 差， 不清楚具体从模块中导入了哪些内容 |
| from modu import sqrt | 稍好 |
import modu import modu.sqrt | 最佳 ， 调用的时候直接使用modu.sqrt能比较清楚的知道当前方法属于哪个模块 |
import os import sys | 推荐 |
import os, sys | 不推荐 |
| from subprocess import Popen, PIPE | 推荐 |
11 Main
主功能应该放在一个main()函数中。
在Python中，pydoc以及单元测试要求模块必须是可导入的。代码应该在执行主程序前总是检查 if __name__ == '__main__'， 这样当模块被导入时主程序就不会被执行。
def main():
...
if __name__ == '__main__':
main()
12 函数设计规范
函数设计的主要目标就是最大化代码重用和最小化代码冗余。精心设计的函数不仅可以提高程序的健壮性，还可以增强可读性、减少维护成本。
函数设计要尽量短小，嵌套层次不宜过深。 所谓短小， 就是尽量避免过长函数， 因为这样不需要上下拉动滚动条就能获得整体感观， 而不是来回翻动屏幕去寻找某个变量或者某条逻辑判断等。 函数中需要用到 if、 elif、 while 、 for 等循环语句的地方，尽量不要嵌套过深，最好能控制在3层以内。不然有时候为了弄清楚哪段代码属于内部嵌套， 哪段属于中间层次的嵌套， 哪段属于更外一层的嵌套所花费的时间比读代码细节所用时间更多。
尽可能通过参数接受输入，以及通过return产生输出以保证函数的独立性。
尽量减少使用全局变量进行函数间通信。
不要在函数中直接修改可变类型的参数。
函数申明应该做到合理、 简单、 易于使用。 除了函数名能够正确反映其大体功能外， 参数的设计也应该简洁明了， 参数个数不宜太多。 参数太多带来的弊端是： 调用者需要花费更多的时间去理解每个参数的意思，测试的时候测试用例编写的难度也会加大。
函数参数设计应该考虑向下兼容。
13 版本注记
如果要将 RCS 或 CVS 的杂项包含在你的源文件中，按如下格式操作：
__version__ = "$Revision: 1.4 $"
# $Source: E:/cvsroot/python_doc/pep8.txt,v $
对于 CVS 的服务器工作标记更应该在代码段中明确出它的使用说明，如在文档最开始的版权声明后应加入如下版本标记：
# 文件：$id$
# 版本：$Revision$
这样的标记在提交给配置管理服务器后，会自动适配成为相应的字符串，如：
# 文件：$Id: ussp.py,v 1.22 2004/07/21 04:47:41 hd Exp $
# 版本：$Revision: 1.4 $
这些应该包含在模块的文档字符串之后，所有代码之前，上下用一个空行分割。
感谢各位的阅读，以上就是“Python编码规范知识点实例分析”的内容了，经过本文的学习后，相信大家对Python编码规范知识点实例分析这一问题有了更深刻的体会，具体使用情况还需要大家实践验证。这里是创新互联，小编将为大家推送更多相关知识点的文章，欢迎关注！
本文标题：Python编码规范知识点实例分析
分享URL：
http://cdkjz.cn/article/psehsp.html
