1. 文件头部加入#-*-conding:utf-8-*-标识

2. def func(arg1, arg2):
       """在这里写函数的一句话总结(如: 计算平均值).
   
       这里是具体描述.
   
       参数
       ----------
       arg1 : int
           arg1的具体描述
       arg2 : int
           arg2的具体描述
   
       返回值
       -------
       int
           返回值的具体描述
   
       参看
       --------
       otherfunc : 其它关联函数等...
   
       示例
       --------
       示例使用doctest格式, 在`>>>`后的代码可以被文档测试工具作为测试用例自动运行
   
       >>> a=[1,2,3]
       >>> print [x + 3 for x in a]
       [4, 5, 6]
       """

https://zhuanlan.zhihu.com/p/29143263