python - Python 函数中 return 语句前的空行

Question

我在返回之前找不到任何关于使用空行的 PEP 引用，所以想知道什么是常见做法。

示例 A1:

def add(a,b):
    """ docstrings"""
    a = a + 2
    b = b + 2
    c = a +b
    return c

示例 A2:

def add(a,b):
    """ docstrings"""
    a = a + 2
    b = b + 2
    c = a +b

    return c

示例 B1:

def add(a,b):
    """ docstrings"""
    if a > b:
       c = a + b
    else:
       c = a -b
    return c

示例 B2:

def add(a,b):
    """ docstrings"""
    if a > b:
       c = a + b
    else:
       c = a -b

    return c

示例 C1:

def add(a):
    """ docstrings"""
    for i in range(3):
       a = a + i
    return a

示例 C2:

def add(a):
    """ docstrings"""
    for i in range(3):
       a = a + i

    return a

在这些用例(A、B、C)中，哪些是常见的做法？如果在 return 语句之前涉及 if-else 块或循环，有什么变化吗？

Answer 1

return 没有常见的做法(至少我在风格 PEP 中没有看到过)。 s 和空行。

但是有一个关于空行和文档字符串(见 PEP 257 ):

There's no blank line either before or after the docstring.

但是也:

Insert a blank line after all docstrings (one-line or multi-line) that document a class -- generally speaking, the class's methods are separated from each other by a single blank line, and the docstring needs to be offset from the first method by a blank line.

(强调我的)

我经常看到循环后的空行，有时也会看到 return 之前的空行但这取决于函数/循环的长度。通常更重要的是决定一种风格(如果没有现有的约定)并坚持下去。

如 PEP8把它:

A style guide is about consistency. Consistency with this style guide is important. Consistency within a project is more important. Consistency within one module or function is the most important.

然而，重要的是 PEP8 建议谨慎使用空行并分隔逻辑部分(我认为这不是“返回”而是 YMMV 的逻辑部分):

Use blank lines in functions, sparingly, to indicate logical sections.

(强调我的)