个人中心
文章发布
退出
作者热门文章
- ubuntu12.04环境下使用kvm ioctl接口实现最简单的虚拟机
- Ubuntu 通过无线网络安装Ubuntu Server启动系统后连接无线网络的方法
- 在Ubuntu上搭建网桥的方法
- ubuntu 虚拟机上网方式及相关配置详解
30
4
CFSDN坚持开源创造价值，我们致力于搭建一个资源共享平台，让每一个IT人在这里找到属于你的精彩世界.
这篇CFSDN的博客文章基于Google的Python编码规范标准由作者收集整理，如果你对这篇文章有兴趣，记得点赞哟.
本项目并非 Google 官方项目, 而是由国内程序员凭热情创建和维护.
如果你关注的是 Google 官方英文版, 请移步 Google Style Guide 。
以下代码中 Yes 表示推荐，No 表示不推荐.
不要在行尾加分号, 也不要用分号将两条命令放在同一行.
每行不超过80个字符 。
以下情况除外:
Python会将 圆括号, 中括号和花括号中的行隐式的连接起来 , 你可以利用这个特点. 。
如果需要, 你可以在表达式外围增加一对额外的圆括号.
|
1
2
3
4
5
|
推荐: foo_bar(
self
, width, height, color
=
'black'
, design
=
None
, x
=
'foo'
,
emphasis
=
None
, highlight
=
0
)
if
(width
=
=
0
and
height
=
=
0
and
color
=
=
'red'
and
emphasis
=
=
'strong'
):
|
如果一个文本字符串在一行放不下, 可以使用圆括号来实现隐式行连接
|
1
2
|
x = ('这是一个非常长非常长非常长非常长 '
'非常长非常长非常长非常长非常长非常长的字符串')
|
在注释中，如果必要，将长的URL放在一行上.
|
1
2
|
Yes:
# See details at
# http://www.example.com/us/developer/documentation/api/content/v2.0/csv_file_name_extension_full_specification.html
|
|
1
2
3
|
No:
# See details at
# http://www.example.com/us/developer/documentation/api/content/\
# v2.0/csv_file_name_extension_full_specification.html
|
注意上面例子中的元素缩进; 你可以在本文的 :ref:`缩进 <indentation>`部分找到解释. 。
宁缺毋滥的使用括号 。
除非是用于实现行连接, 否则不要在返回语句或条件语句中使用括号. 。
不过在元组两边使用括号是可以的. 。
|
1
2
3
4
5
6
7
8
9
10
|
Yes:
if
foo:
bar()
while
x:
x
=
bar()
if
x
and
y:
bar()
if
not
x:
bar()
return
foo
for
(x, y)
in
dict
.items(): ...
|
|
1
2
3
4
5
|
No:
if
(x):
bar()
if
not
(x):
bar()
return
(foo)
|
用4个空格来缩进代码 。
绝对不要用tab, 也不要tab和空格混用. 。
对于行连接的情况, 你应该要么垂直对齐换行的元素(见 :ref:`行长度 <line_length>` 部分的示例).
或者使用4空格的悬挂式缩进(这时第一行不应该有参数)
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
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 个空格缩进
foo
=
{
long_dictionary_key:
long_dictionary_value,
...
}
|
|
1
2
3
4
5
6
7
8
9
10
11
12
13
|
No:
# 第一行有空格是禁止的
foo
=
long_function_name(var_one, var_two,
var_three, var_four)
# 2 个空格是禁止的
foo
=
long_function_name(
var_one, var_two, var_three,
var_four)
# 字典中没有处理缩进
foo
=
{
long_dictionary_key:
long_dictionary_value,
...
}
|
顶级定义之间空两行, 方法定义之间空一行 。
顶级定义之间空两行, 比如函数或者类定义. 方法定义, 类定义与第一个方法之间, 都应该空一行. 。
函数或方法中, 某些地方要是你觉得合适, 就空一行. 。
按照标准的排版规范来使用标点两边的空格 。
括号内不要有空格. 。
按照标准的排版规范来使用标点两边的空格 。
|
1
|
Yes: spam(ham[
1
], {eggs:
2
}, [])
|
|
1
|
No: spam( ham[
1
], { eggs:
2
}, [ ] )
|
不要在逗号, 分号, 冒号前面加空格, 但应该在它们后面加(除了在行尾). 。
|
1
2
3
|
Yes:
if
x
=
=
4
:
print
x, y
x, y
=
y, x
|
|
1
2
3
|
No:
if
x
=
=
4
:
print
x , y
x , y
=
y , x
|
参数列表, 索引或切片的左括号前不应加空格. 。
|
1
|
Yes: spam(
1
)
|
|
1
|
no: spam (
1
)
|
|
1
|
Yes:
dict
[
'key'
]
=
list
[index]
|
|
1
|
Yes:
dict
[
'key'
]
=
list
[index]
|
在二元操作符两边都加上一个空格.
比如赋值(=), 比较(==, <, >, !=, <>, <=, >=, in, not in, is, is not), 布尔(and, or, not). 。
至于算术操作符两边的空格该如何使用, 需要你自己好好判断. 不 。
过两侧务必要保持一致. 。
|
1
|
Yes: x
=
=
1
|
|
1
|
No: x<
1
|
当'='用于指示关键字参数或默认参数值时, 不要在其两侧使用空格. 。
|
1
|
Yes:
def
complex
(real, imag
=
0.0
):
return
magic(r
=
real, i
=
imag)
|
|
1
|
No:
def
complex
(real, imag
=
0.0
):
return
magic(r
=
real, i
=
imag)
|
不要用空格来垂直对齐多行间的标记, 因为这会成为维护的负担(适用于:, #, =等)
|
1
2
3
4
5
6
7
|
Yes:
foo
=
1000
# 注释
long_name
=
2
# 注释不需要对齐
dictionary
=
{
"foo"
:
1
,
"long_name"
:
2
,
}
|
|
1
|
No:<br> foo
=
1000
# 注释<br> long_name = 2 # 注释不需要对齐<br> dictionary = {<br> "foo" : 1,<br> "long_name": 2,<br> }
|
以上就是基于Google的Python编码规范标准的详细内容，更多关于Google的Python编码规范的资料请关注我其它相关文章！ 。
原文链接：https://blog.csdn.net/weixin_39032019/article/details/117251584 。
最后此篇关于基于Google的Python编码规范标准的文章就讲到这里了,如果你想了解更多关于基于Google的Python编码规范标准的内容请搜索CFSDN的文章或继续浏览相关文章，希望大家以后支持我的博客！ 。
30
4
0
我正在处理一组标记为 160 个组的 173k 点。我想通过合并最接近的(到 9 或 10 个组)来减少组/集群的数量。我搜索过 sklearn 或类似的库，但没有成功。 我猜它只是通过 knn 聚类
我有一个扁平数字列表，这些数字逻辑上以 3 为一组，其中每个三元组是 (number, __ignored, flag[0 or 1])，例如: [7,56,1, 8,0,0, 2,0,0, 6,1,
我正在使用 pipenv 来管理我的包。我想编写一个 python 脚本来调用另一个使用不同虚拟环境(VE)的 python 脚本。 如何运行使用 VE1 的 python 脚本 1 并调用另一个 p
假设我有一个文件 script.py 位于 path = "foo/bar/script.py"。我正在寻找一种在 Python 中通过函数 execute_script() 从我的主要 Python
这听起来像是谜语或笑话，但实际上我还没有找到这个问题的答案。 问题到底是什么？ 我想运行 2 个脚本。在第一个脚本中，我调用另一个脚本，但我希望它们继续并行，而不是在两个单独的线程中。主要是我不希望第
我有一个带有 python 2.5.5 的软件。我想发送一个命令，该命令将在 python 2.7.5 中启动一个脚本，然后继续执行该脚本。 我试过用 #!python2.7.5 和http://re
我在 python 命令行(使用 python 2.7)中，并尝试运行 Python 脚本。我的操作系统是 Windows 7。我已将我的目录设置为包含我所有脚本的文件夹，使用: os.chdir("
剧透:部分解决(见最后)。 以下是使用 Python 嵌入的代码示例: #include int main(int argc, char** argv) { Py_SetPythonHome
假设我有以下列表，对应于及时的股票价格: prices = [1, 3, 7, 10, 9, 8, 5, 3, 6, 8, 12, 9, 6, 10, 13, 8, 4, 11] 我想确定以下总体上最
所以我试图在选择某个单选按钮时更改此框架的背景。 我的框架位于一个类中，并且单选按钮的功能位于该类之外。 (这样我就可以在所有其他框架上调用它们。) 问题是每当我选择单选按钮时都会出现以下错误: co
我正在尝试将字符串与 python 中的正则表达式进行比较，如下所示， #!/usr/bin/env python3 import re str1 = "Expecting property name
考虑以下原型(prototype) Boost.Python 模块，该模块从单独的 C++ 头文件中引入类“D”。 /* file: a/b.cpp */ BOOST_PYTHON_MODULE(c)
如何编写一个程序来“识别函数调用的行号？” python 检查模块提供了定位行号的选项，但是， def di(): return inspect.currentframe().f_back.f_l
我已经使用 macports 安装了 Python 2.7，并且由于我的 $PATH 变量，这就是我输入 $ python 时得到的变量。然而，virtualenv 默认使用 Python 2.6，除
我只想问如何加快 python 上的 re.search 速度。 我有一个很长的字符串行，长度为 176861(即带有一些符号的字母数字字符)，我使用此函数测试了该行以进行研究: def getExe
list1= [u'%app%%General%%Council%', u'%people%', u'%people%%Regional%%Council%%Mandate%', u'%ppp%%Ge
这个问题在这里已经有了答案: Is it Pythonic to use list comprehensions for just side effects? (7 个答案) 关闭 4 个月前。 告
我想用 Python 将两个列表组合成一个列表，方法如下: a = [1,1,1,2,2,2,3,3,3,3] b= ["Sun", "is", "bright", "June","and" ,"Ju
我正在运行带有最新 Boost 发行版 (1.55.0) 的 Mac OS X 10.8.4 (Darwin 12.4.0)。我正在按照说明 here构建包含在我的发行版中的教程 Boost-Pyth
学习 Python，我正在尝试制作一个没有任何第 3 方库的网络抓取工具，这样过程对我来说并没有简化，而且我知道我在做什么。我浏览了一些在线资源，但所有这些都让我对某些事情感到困惑。 html 看起来
我是一名优秀的程序员,十分优秀！