众所周知，熟悉Python的小伙们接触最多的就是函数，函数是组织好的、可重复使用的、用来实现单一或相关联功能的代码段。

函数能提高应用的模块性和代码的重复利用率。除了Python提供了许多内建函数，比如print()。而我们接触最频繁的就是用户自定义函数。

函数定义

函数定义要素：

• def关键词，后接函数标识符名称和圆括号 ()。

• 参数，任何传入参数和自变量必须放在圆括号中间，圆括号之间可以用于定义参数。

• 函数的第一行语句可以选择性地使用文档字符串—用于存放函数说明。

• 函数内容以冒号: 起始，并且缩进。

• return [表达式] 结束函数，选择性地返回一个值给调用方，不带表达式的 return 相当于返回 None。

不定长参数

函数更多地使用场景是根据动态的输入返回动态的结果，这样入参必须是变量。而入参的类型也是有多种的，例如定长和不定长参数，定长参数大家接触的最多，不做赘述，简单介绍下不定长参数：

有时，你可能需要一个函数能处理比当初声明时更多的参数，这些参数叫做不定长参数，和定长参数不同，声明时不会命名。基本语法如下：

def functionname([formal_args,] *var_args_tuple ):   "函数_文档字符串"   function_suite   return [expression]

注意：加了星号 * 的参数会以元组(tuple)的形式导入，存放所有未命名的变量参数。如果在函数调用时没有指定参数，它就是一个空元组。

# 函数说明def printinfo(arg1, *vartuple):  "打印任何传入的参数"  print("输出: ")  print(arg1)  print(vartuple)​# 调用printinfo 函数printinfo(70, 60, 50)printinfo(70)

还有一种就是参数带两个星号 **基本语法如下：

def functionname([formal_args,] **var_args_dict ):   "函数_文档字符串"   function_suite   return [expression]

函数开发四条原则

为了使代码更好的复用和最小程度的代码冗余，掌握函数开发的四个原则尤为重要。

案例嘛，就翻翻github，捞一下我几年前刚学python那会写的代码，看看会不会有什么意外收获。

这个函数实现了自动根据播单id，下载MP3音频的功能。可以分为三个步骤：

1. 请求播单，得到播单响应

2. 提取播单中MP3地址

3. 下载MP3音频并保存到本地

原则一：函数设计要尽量小，嵌套层次不宜过深。

所谓小，就是尽量避免过长函数，因为这样不需要上下拉动滚动条就能获得整体感观，而不是来回翻动屏幕去寻找某个变量或者某条逻辑判断等。函数中需要用到if、elif、while、for等循环语句的地方，尽量不要嵌套过深，最好能控制在3层以内。相信很多人有过这样的经历：为了弄清楚哪段代码属于内部嵌套，哪段属于中间层次的嵌套，哪段属于更外一层”

原则二：函数声明应该做到合理、简单且参数不易太多。

试想，当你看到一个函数名和其实现逻辑不一致的时候作何感想。函数命名应“反映其大体功能外，参数的设计也应该简洁明了，参数个数不宜太多。参数太多带来的弊端是：调用者需要花费更多的时间去理解每个参数的意思，测试人员需要花费更多的精力来设计测试用例，以确保参数的组合能够有合理的输出，这使覆盖测试的难度大大增加。

最近在看《像火箭科学家一样思考》一书【强推此书】，里面就有讲到对复杂与简单的看法，就函数而言，每增加一个参数，就增加函数自身可能出错的风险。

原则三：函数参数设计应该考虑向下兼容。

这个对于经常做项目的同学应该更有体感，敏捷开发模式下，项目迭代更快，对于比较大的项目，可能存在多项目并行的情况，一套代码由多条线并行开发。那么，这种模式下，你设计的函数 就必须 要预见到未来可能会扩展到的功能。例如一个大项目拆分成多个小项目迭代完成，这样你在设计函数初期就必须考虑到未来函数升级需要兼顾到地方，为未来升级留下“口子”，不致于每次迭代都要打改动。

例如本案例，后面要求将下载的音频按类目保存到不同的文件夹下面，那么这样就必须根据MP3的地址动态选择要存放的文件夹，所以函数入参就必须增加一个目录的参数，试想，如果在本代码上改动，影响范围有多大呢？

当然解法也有，就是在函数设计之初就预留不定长参数或默认参数，以备不时之需。

def DownLoadMp3(id, dir=social):

原则四：函数职责尽可能单一。

要保证一个函数只做一件事，就要尽量保证抽象层级的一致性，所有的语句尽量在一个粒度上。同时在一个函数中处理多件事情也不利于代码的重用。本案例的改进版，可以将代码拆分成三部分：信息提取、下载、流程编排。具体实现如下：

# 1.获取音频Mp3信息def getMp3Response(id):​    url = "http://fm.xinli001.com/broadcast"    querystring = {"pk": id}    headers = {'accept': "application/json, text/javascript, */*; q=0.01",'x-requested-with': "XMLHttpRequest",'user-agent': "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/76.0.3809.132 Safari/537.36",'cache-control': "no-cache",'postman-token': "3a95a7d6-5834-f6ae-5678-82b496bf9c71"    }    response = requests.request("GET", url, headers=headers, params=querystring)    print(response.text)try:        res = json.loads(response.text)except:        res = ''return res​# 2.保存为MP3, 保存到特定文件夹下面：文件夹以专辑名字命名def saveAudio(url, album, filename):    filepath = os.getcwd()+'/mp3/'+albumif os.path.exists(filepath):        mp3 = os.path.join(filepath + '/', '' + filename + '.mp3')if url == '':            print('the url is NUll, pass')else:            urllib.request.urlretrieve(url, mp3, cbk)            print(filename+'下载完毕')else:        os.makedirs(filepath)        mp3 = os.path.join(filepath + '/', '' + filename + '.mp3')if url == '':            print('the url is NUll, pass')else:            urllib.request.urlretrieve(url, mp3, cbk)            print(filename+' 下载完毕')​# 3.main函数实现流程编排   def main():  album = '壹心理'for id in range(38, 99395999):    res = getMp3Response(id)if res:try:        title = str(id) + '-' + res.get('data').get('title')        url = res.get('data').get('url')        saveAudio(url, album, title)except:        print(str(res) + '为空')

往期推荐

接口间参数传递的一种解决方案

经验分享｜测试工程师转型测试开发历程

技术面必考：多线程、多进程

接口自动化测试框架设计思路

接口自动化测试框架实践1：接口测试概述

我在阿里做测开