个性代码注释大合集
(图片来源网络,侵删)1.1 函数说明注释
def function_name(parameters): """ 函数名(function_name) 功能描述: 这个函数的主要作用是什么? 参数: parameters: 参数类型,参数名称,参数描述。 返回值: 返回值类型,返回值名称,返回值描述。 示例: function_name("example") """ # 函数实现代码1.2 方法说明注释
class ClassName: def method_name(self, parameters): """ 方法名(method_name) 功能描述: 这个方法的主要作用是什么? 参数: parameters: 参数类型,参数名称,参数描述。 返回值: 返回值类型,返回值名称,返回值描述。 示例: object.method_name("example") """ # 方法实现代码2.1 类说明注释
class ClassName: """ 类名(ClassName) 功能描述: 这个类的主要作用是什么? 属性: attribute_name: 属性类型,属性名称,属性描述。 方法: method_name: 方法描述。 示例: obj = ClassName() """ # 类实现代码
2.2 模块说明注释
""" 模块名(module_name) 功能描述: 这个模块的主要作用是什么? 包含的类: ClassName: 类描述。 包含的函数: function_name: 函数描述。 示例: import module_name """ 模块实现代码
下面是一个示例介绍,展示了各种风格的个性代码注释:
| 序号 | 代码风格 | 注释示例 |
| 1 | 文艺风 | // 梦里花落知多少,程序也应有诗和远方 |
| 2 | 调皮风 | // 这行代码是认真的,别笑,它会脸红 |
| 3 | 暴力风 | // 严禁删除,否则这段代码会让你好看 |
| 4 | 哲理风 | // 一行代码,一个世界,一花一叶一宇宙 |
| 5 | 脑洞风 | // 如果这行代码出了bug,那就召唤神龙吧! |
| 6 | 学术风 | // 请参考Knuth的《计算机程序设计艺术》来理解此处的算法优化 |
| 7 | 搞笑风 | // 请勿在月球上运行此代码,以免引发星球大战 |
| 8 | 简洁风 | // 输出:世界和平 |
| 9 | 老干部风 | // 勤奋严谨,求实创新,编程也如此 |
| 10 | 艺术风 | // 这段代码就像蒙德里安的画,简洁而不简单 |
这个介绍仅供参考,你可以根据自己的喜好和需求来添加或修改注释风格,希望这能给你的编程生活带来一些乐趣!
(图片来源网络,侵删)
(图片来源网络,侵删)
上一篇:cdn和劫持_CDN防劫持吗
下一篇:服务器配置文档_密钥配置文档