Python代码整洁之道02--有意义的命名，真的那么重要吗?~上篇
off999 2024-11-01 12:49 20 浏览 0 评论
一、Python学习中有哪些地方需要命名？
● 变量
● 函数
● 参数
● 类
● 源代码
● 源代码所在目录
都9102年，如果对这些概念不清楚，Python大星帮你开小灶
二、Python学习中需遵守的命名规则
1、名副其实
● 选个好名字需要花时间，但省下来的时间比花掉多
● 一旦发现更好的名称，就换掉旧的
● 读你代码的人（包括你自己）都会很开心
图1，名称d什么都没有说明。工作中谁要是这么写...
图2，选择体现本意的名称能让人更容易理解和修改代码
图3，没有复杂的表达式，只用到3个变量和2个常量
为什么难以说明图中的代码要做什么事？
问题不在于代码的简洁度
而是在于代码的模糊度
有3个问题，Python大星要提出批评：
● 函数名getThem是神马意思？
● x[0]是神马意思？
● 值4的意义是神马？
如何让图3中的代码变得有意义？
我们在开发一种扫雷游戏
我们发现盘面是
名为theList的单元格列表
那就将其名称修改为gameBoard
x[0]中的0是一种状态值
而这种状态值为4表示“已标记”
只要改为有意义的名称
代码就会得到相当程度的改进
Python并未提供如C/C++/Java一样的const/final修饰符。但是...
Python提供了新的方法实现常量：
通过自定义类实现常量
● 自定义常量类
● 结合图3改进代码
2、避免误导
● hp、aix和sco都不应该做变量名，因它们都是UNIX平台的专有名词
● 别用accountlist来指称一组账号，除非它真的是list类型，如果并非真的是个list，可以使用
accountgroup或者直接用accounts
● 尽量少使用外形相似的名称，区分会耗费时间
● 不用用小写字母l和大写字母O作为变量名，尤其在组合的时候。问题在于他们看起来完全像是常量“壹”和“零”
3、做有意义的区分
如果程序猿只是为了满足编译器或者解释器的需要而写代码，就会制造麻烦
● 以数字系列命名（a1、a2，......aN）
这样的名称纯属误导 --
完全没有提供正确的信息，没有提供导向作者意图的线索。
如果参数名改为source和destination，这个函数就像样的多。
● 废话是另一种没有意义的区分
假设你有Product类，还有ProductInfo或者ProductData类
那么他么名字虽然不同
意思却无区别
Info和Data就像a、an和the一样
是意义含混的废话
① variable一词永远不要出现在变量名中
② table一词永远不要出现在表名中
③ namestr会比name好吗？
难道name会是一个浮点数不成？
④ 如果缺少明确约定
变量moneyamount 就与money没区别
customerinfo与customer没区别
accountdata与account没区别
themessage也与message没区别
要区分名称，就要以读者能鉴别不同之处的方式来区分。
相关推荐
- Python四种常用的高阶函数，你会用了吗
-
每天进步一点点，关注我们哦，每天分享测试技术文章本文章出自【码同学软件测试】码同学公众号：自动化软件测试码同学抖音号：小码哥聊软件测试1、什么是高阶函数把函数作为参数传入，这样的函数称为高阶函数例如：...
- Python之函数进阶-函数加强(上)（python函数的作用增强代码的可读性）
-
一.递归函数递归是一种编程技术，其中函数调用自身以解决问题。递归函数需要有一个或多个终止条件，以防止无限递归。递归可以用于解决许多问题，例如排序、搜索、解析语法等。递归的优点是代码简洁、易于理解，并...
- 数据分析-一元线性回归分析Python
-
前面几篇介绍了数据的相关性分析，通过相关性分析可以看出变量之间的相关性程度。如果我们已经发现变量之间存在明显的相关性了，接下来就可以通过回归分析，计算出具体的相关值，然后可以用于对其他数据的预测。本篇...
- python基础函数（python函数总结）
-
Python函数是代码复用的核心工具，掌握基础函数的使用是编程的关键。以下是Python函数的系统总结，包含内置函数和自定义函数的详细用法，以及实际应用场景。一、Python内置函数（...
- python进阶100集(9)int数据类型深入分析
-
一、基本概念int数据类型基本上来说这里指的都是整形，下一届我们会讲解整形和浮点型的转化，以及精度问题！a=100b=a这里a是变量名，100就是int数据对象，b指向的是a指向的对象，...
- Python学不会来打我(73)python常用的高阶函数汇总
-
python最常用的高阶函数有counter()，sorted()，map()，reduce()，filter()。很多高阶函数都是将一个基础函数作为第一个参数，将另外一个容器集合作为第二个参数，然...
- python中有哪些内置函数可用于编写数值表达式?
-
在Python中，用于编写数值表达式的内置函数很多，它们可以帮助你处理数学运算、类型转换、数值判断等。以下是常用的内置函数（不需要导入模块）按类别归类说明：一、基础数值处理函数函数作用示例ab...
- 如何在Python中获取数字的绝对值?
-
Python有两种获取数字绝对值的方法：内置abs()函数返回绝对值。math.fabs()函数还返回浮点绝对值。abs()函数获取绝对值内置abs()函数返回绝对值，要使用该函数，只需直接调用：a...
- 【Python大语言模型系列】使用dify云版本开发一个智能客服机器人
-
这是我的第359篇原创文章。一、引言上篇文章我们介绍了如何使用dify云版本开发一个简单的工作流：【Python大语言模型系列】一文教你使用dify云版本开发一个AI工作流（完整教程）这篇文章我们将引...
- Python3.11版本使用thriftpy2的问题
-
Python3.11于2022年10月24日发布，但目前thriftpy2在Python3.11版本下无法安装，如果有使用thriftpy2的童鞋，建议晚点再升级到最新版本。...
- uwsgi的python2+3多版本共存（python多版本兼容）
-
一、第一种方式（virtualenv）1、首先，机器需要有python2和python3的可执行环境。确保pip和pip3命令可用。原理就是在哪个环境下安装uwsgi。uwsgi启动的时候，就用的哪个...
- 解释一下Python脚本中版本号声明的作用
-
在Python脚本中声明版本号（如__version__变量）是一种常见的元数据管理实践，在IronPython的兼容性验证机制中具有重要作用。以下是版本号声明的核心作用及实现原理：一、版本号...
- 除了版本号声明，还有哪些元数据可以用于Python脚本的兼容性管理
-
在Python脚本的兼容性管理中，除了版本号声明外，还有多种元数据可以用于增强脚本与宿主环境的交互和验证。以下是一些关键的元数据类型及其应用场景：一、环境依赖声明1.Python版本要求pyth...
- 今年回家没票了?不，我有高科技抢票
-
零基础使用抢票开源软件Py12306一年一度的抢票季就要到了，今天给大家科普一下一款软件的使用方法。软件目前是开源的，禁止用于商用。首先需要在电脑上安装python3.7，首先从官网下载对应的安装包，...
- 生猛!春运抢票神器成GitHub热榜第一，过年回家全靠它了
-
作者：车栗子发自：凹非寺量子位报道春节抢票正在如火如荼的进行，过年回家那肯定需要抢票，每年的抢票大战，都是一场硬战，没有一个好工具，怎么能上战场死锁呢。今天小编推荐一个Python抢票工具，送到...
欢迎 你 发表评论:
- 一周热门
- 最近发表
- 标签列表
-
- python计时 (73)
- python安装路径 (56)
- python类型转换 (93)
- python进度条 (67)
- python吧 (67)
- python字典遍历 (54)
- python的for循环 (65)
- python格式化字符串 (61)
- python静态方法 (57)
- python列表切片 (59)
- python面向对象编程 (60)
- python 代码加密 (65)
- python串口编程 (60)
- python读取文件夹下所有文件 (59)
- java调用python脚本 (56)
- python操作mysql数据库 (66)
- python获取列表的长度 (64)
- python接口 (63)
- python调用函数 (57)
- python多态 (60)
- python匿名函数 (59)
- python打印九九乘法表 (65)
- python赋值 (62)
- python异常 (69)
- python元祖 (57)