为什么禁止把函数参数默认值设置为可变对象?

本文主要是对禁止使用可变对象作为参数默认值的编码规范进行了详细介绍。

今天给大家带来的是一篇编程规范方面的内容。

有时候我们在编写函数时,会需要给一些参数设置默认值,这个时候我们需要牢记一点:禁止使用可变对象作为参数默认值

从一个“反例”开始

我们先编写一个不符合规范的“反例”看看:

# 【反例】
def f(a, lst=[]):
    lst.append(a)
    return lst

在上面的反例中,我们就使用了可变对象列表,作为我们的参数默认值。

接下来我们用静态代码检查工具pylint检查一下上面的“反例“:

pylint example.py


# Output
************* Module example
example.py:1:0: C0114: Missing module docstring (missing-module-docstring)
example.py:1:0: W0102: Dangerous default value [] as argument (dangerous-default-value)
example.py:1:0: C0103: Function name "f" doesn't conform to snake_case naming style (invalid-name)
example.py:1:0: C0103: Argument name "a" doesn't conform to snake_case naming style (invalid-name)
example.py:1:0: C0116: Missing function or method docstring (missing-function-docstring)

------------------------------------
Your code has been rated at -6.67/10

这里主要看第二条建议:example.py:1:0: W0102: Dangerous default value [] as argument (dangerous-default-value)

非常明显地提示列表[]是一个危险的默认值,这究竟是为什么呢?

为什么可变对象作为函数默认值很危险?

我们还是使用上面那个简单的“反例”,再传递几个参数,通过结果,就可以明显地看到为什么不建议我们这样做了。

# 【反例】
def f(a, lst=[]):
    lst.append(a)
    return lst

print(f('1'))  # 期望 -> ['1']
print(f('2'))  # 期望 -> ['2']
print(f('3', []))  # 期望 -> ['3']
print(f('3', ['1', '2']))  # 期望 -> ['1', '2', '3']


# 实际输出
['1']
['1', '2']
['3']
['1', '2', '3']

从结果我们可以看到,第二次调用函数f('2')的结果是跟我们预期不符的,我们本来的期望值是没有传入lst参数,那么应该给我们返回一个['2'],但是实际结果却是['1', '2']

这是因为Python函数的默认值只会创建一次,之后第二次调用的时候就是在原默认值上进行修改,而不是重新创建了一个新的默认值,这也就能够解释得通实际结果为什么是这样的了。

所以说,使用可变对象作为默认值会导致得到超出我们预期的结果,这可能会导致出现一些无法定位的bug。

那么,我们应该怎么做?

我们应该怎么做?

既然我们不能使用可变对象作为参数默认值,那么使用不可变对象作为参数默认值就好了,然后再在代码中对默认值的数据类型进行修改。

# 【正例】写法一
def f(a, lst=None):
    if not lst:
        lst = []
    lst.append(a)
    return lst

print(f('1'))  # 期望 -> ['1']
print(f('2'))  # 期望 -> ['2']
print(f('3', []))  # 期望 -> ['3']
print(f('3', ['1', '2']))  # 期望 -> ['1', '2', '3']


# 实际输出
['1']
['2']
['3']
['1', '2', '3']

可以看到,把参数默认值设置为不可变对象的写法就完全符合我们的预期了。

我们还可以简化成下面的写法:

# 【正例】写法二
def f(a, lst=None):
    lst = lst or []
    lst.append(a)
    return lst

上面两种写法都是等价的,而且用pylint检查也不会再出现那个警告了。

今天关于这个编码规范的介绍就到此结束了,喜欢的朋友们可以点一个关注,后续会输出更多关于Python编码规范的相关内容。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 220,137评论 6 511
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,824评论 3 396
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 166,465评论 0 357
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,131评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,140评论 6 397
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,895评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,535评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,435评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,952评论 1 319
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,081评论 3 340
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,210评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,896评论 5 347
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,552评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,089评论 0 23
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,198评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,531评论 3 375
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,209评论 2 357

推荐阅读更多精彩内容