[Python]编码规范性(四)——注释(属性、格式)
属性
(必须遵守)(规则):
3、公共属性的注释写在属性声明的上方,与声明保持同样的缩进;
行内注释应以#和一个空格作为开始,与后面的文字注释以一个空格隔开;
说明:行内注释的形式是在语句上一行中加注释;行内注释要少用,他们应以#和一个空格作为开始;
格式
(必须遵守)(规则):
4、模块文档字符串写在文件的顶部,导入(import)部分之前的位置,不需要缩进;
说明:模块文档字符串应当包含功能描述和版权说明;
""" 功能:XXX类,该类主要涉及XXX功能; 版权信息:MoKin Studio 版本所有(C) 2010-2021 """
5、文档字符串多于一行时,末尾的"""要自成一行;
说明:对于只有一行的文档字符串,把"""放到同一行也没有问题;
6、注释必须与其描述的代码保持同样的缩进,并放在其上方相邻位置;
说明:对代码的注释应放在其上方相邻位置,不可以放在下面;
标签:
Python
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· AI与.NET技术实操系列(二):开始使用ML.NET
· 记一次.NET内存居高不下排查解决与启示
· 探究高空视频全景AR技术的实现原理
· 理解Rust引用及其生命周期标识(上)
· 浏览器原生「磁吸」效果!Anchor Positioning 锚点定位神器解析
· DeepSeek 开源周回顾「GitHub 热点速览」
· 物流快递公司核心技术能力-地址解析分单基础技术分享
· .NET 10首个预览版发布:重大改进与新特性概览!
· AI与.NET技术实操系列(二):开始使用ML.NET
· .NET10 - 预览版1新功能体验(一)