本手册全面解读了PEP 8的各项规定,从基本格式到高级技巧,辅以实际例子,助您掌握Python代码的最佳书写方式。 核心编码规则与示例 1. 缩进与行长度 缩进:统一采用四个空格,避免使用Tab键。 def display_message(): print("Hello from PEP 8 compliant function") 行长限制:保持每一行不超过79个字符,长表达式可以...
#与左括号对齐foo=long_function_name(var_one,var_two,var_three,var_four)#用更多的缩进来与其他行区分deflong_function_name(var_one,var_two,var_three,var_four):print(var_one)#挂行缩进应该再换一行foo=long_function_name(var_one,var_two,var_three,var_four) 不推荐: #没有使用垂直对齐时,禁...
甚至在 Python 的标准库中也存在这样的现象,比如在 threading 模块中,因为这些代码的出现往往早于 PEP 8 规范的诞生,同时为了向后兼容而保留,但通常这些模块都会提供相同功能的以小写加下划线命名的方法,我们应该尽可能使用这些新的方法)。
Yes: # 与起始变量对齐 foo = long_function_name(var_one, var_two, var_three, var_four) # 字典中与起始值对齐 foo = { long_dictionary_key: value1 + value2, ... } # 4 个空格缩进,第一行不需要 foo = long_function_name( var_one, var_two, var_three, var_four) # 字典中 4 个...
7.1 Function Annotations 功能注释 八、其它 8.1 高效,快速方法 8.2 pycharm添加函数注释: 8.3 检测工具 8.4 开头添加 参考 回到顶部 一、Introduction介绍 本文提供的Python代码编码规范基于Python主要发行版本的标准库。Python的C语言实现的C代码规范请查看相应的PEP指南1。
def long_function_name( var_one, var_two, var_three, PEP8 Python 编码规范 PEP8 Python 编码规范 1 代码编排 1.1 缩进。4 个空格的缩进(编辑器都可以完成此功能),不使用 Tap,更不能混合使用 Tap 和空格。 1.2 每行最大长度 79,换行可以使用反斜杠,最好使用圆括号。换行点要在操作符的后 边敲回车...
foo=long_function_name(var_one,var_two,var_three,var_four) 当if语句的条件部分足够长,需要跨多行编写时,值得注意的是,两个字符的关键字(即 if),加上一个空格,再加上一个开括号,会为多行条件的后续行创建一个自然的4个空格缩进。这可能会在if语句内嵌的缩进代码块的可视上产生冲突,后者也会自然地缩进...
比如说下面这样就不需要: x = x + 1 # Increment x 但有时,这样做很有用: x = x + 1 # Compensate for border Documentation Strings 文档字符串 编写好的文档说明(也叫“docstrings”)的约定在PEP 257中永恒不变。 要为所有的公共模块,函数,类以及方法编写文档说明。非公共的方法没有必要,但是应该有一...
Function Annotations 功能注释 参考 Introduction 介绍 本文提供的Python代码编码规范基于Python主要发行版本的标准库。Python的C语言实现的C代码规范请查看相应的PEP指南1。 这篇文档以及PEP 257(文档字符串的规范)改编自Guido原始的《Python Style Guide》一文,同时添加了一些来自Barry的风格指南2。
foo = long_function_name(var_one, var_two, var_three, var_four) # Further indentation required as indentation is not distinguishable. # 需要增加额外的缩进,因为现在的续行的缩进不够明显,不能将其与其他行的缩进区分开来 def long_function_name( ...