当前位置: 代码网 > it编程>前端脚本>Python > Python 命名规范与最佳实践

Python 命名规范与最佳实践

2025年03月17日 Python 我要评论
1. 规范1.变量名区分大小写;2.严禁使用关键字作为变量名;3.确定自己的命名风格,不可随意变换;4.命名应该科学严谨,切勿太长或者表达比较模糊;5.命名中若使用特殊约定或缩写,则要有注释说明;6.

1. 规范

1.变量名区分大小写;

2.严禁使用关键字作为变量名;

3.确定自己的命名风格,不可随意变换;

4.命名应该科学严谨,切勿太长或者表达比较模糊;

5.命名中若使用特殊约定或缩写,则要有注释说明;

6.尽量不要使用中文字符和纯数学字符,避免编码错误;

7.名字由英文字母、数字、下划线组成,如abc,abc13和_abc等;

8.要清晰、明了,有明确含义,同时使用完整的单词或大家基本可以理解的缩写;

9.同一软件产品内,应规划好接口部分(变量、结构、函数及常量)的命名,防止编译、链接时产生冲突。

2. 参考

类型公有/外部成员私有/内部成员
模块(module)my_naming_convention_my_naming_convention
包(package)my_naming_convention
类(class)mynamingconvention_mynamingconvention
异常(exception)mynamingconvention
函数(function)my_naming_convention()_my_naming_convention()
全局/类常量(constant)my_naming_convention_my_naming_convention
全局/类变量(variable)my_naming_convention_my_naming_convention

3. 缩写

命名应当尽量使用全拼写的单词,缩写的情况有如下两种:

  • 常用的缩写,如xml、id等,在命名时也应只大写首字母,如xmlparser。

  • 命名中含有长单词,对某个单词进行缩写。这时应使用约定成俗的缩写方式。

例如:

function 缩写为 fn

text 缩写为 txt

object 缩写为 obj

count 缩写为 cnt

number 缩写为 num

4. 前导后缀下划线

  • 一个前导下划线:表示非公有。
  • 一个后缀下划线:避免关键字冲突。
  • 两个前导下划线:当命名一个类属性引起名称冲突时使用。
  • 两个前导和后缀下划线:“魔”(有特殊用图)对象或者属性,例如__init__或者__file__。绝对不要创造这样的名字,而只是使用它们。

注意:关于下划线的使用存在一些争议。

5. 应该避免的名称

  • 单字母名称, 除了计数器和迭代器.
  • 包/模块名中的连字符(-)
  • 双下划线开头并结尾的名称(python 保留, 例如__init__)

到此这篇关于python 命名规范与最佳实践的文章就介绍到这了,更多相关python 命名规范内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!

(0)

相关文章:

版权声明:本文内容由互联网用户贡献,该文观点仅代表作者本人。本站仅提供信息存储服务,不拥有所有权,不承担相关法律责任。 如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 2386932994@qq.com 举报,一经查实将立刻删除。

发表评论

验证码:
Copyright © 2017-2025  代码网 保留所有权利. 粤ICP备2024248653号
站长QQ:2386932994 | 联系邮箱:2386932994@qq.com