编码风格 - 括号放在同一行还是新的一行？

Question

假设你在调用一个函数，但为了让代码更容易读懂，你需要把这行代码拆成几行。不过，有至少两种方法可以做到这一点：

你会选择这样写：

return render(request, template,
              {
                'var1' : value1,
                'var2' : value2,
                'var3' : value3
               }
             )

还是你更喜欢这样写：

return render \
(
    request, template,
    {
        'var1' : value1,
        'var2' : value2,
        'var3' : value3
    }
)

或者，你也可以提出你自己的格式建议。请说明你选择某种格式的原因，以及另一种格式有什么问题。

谢谢！

Answer 1

我会这样做：

vars = {
    'var1' : value1,
    'var2' : value2,
    'var3' : value3,
}
return render(request, template, vars)

Answer 2

Python的官方文档中有个叫做PEP-8的规范，它推荐使用第一种方式。

Answer 3

我可能会这样做：

return render(
    request, 
    template,
    {
        'var1' : value1,
        'var2' : value2,
        'var3' : value3
    }
)

我会把括号放在同一行，这样搜索 render( 时能找到。而且我觉得这样更清晰。不过，我会把所有的参数放在新的一行。