这7个Python技巧，让我的代码像小说一样好读

我写Python写了七八年，见过太多代码像天书一样难懂。今天说七个技巧，都是自己踩坑踩出来的经验，不是什么高深理论，就是些实在的写法。

第一个技巧，变量命名要像给人起外号。你给同事起外号，肯定挑他最明显的特征。变量也一样，user_list 就比 l 强一百倍，is_active 就比 flag 清楚。我见过有人用 a、b、c 当变量名，三个月后自己都看不懂。

第二个技巧，函数要短。一个函数写个三五十行，看着就头疼。每个函数只干一件事，干完就走。我一般限制在十五行以内，超了就拆。拆出来的小函数名字就是注释，读代码的人不用猜你在干嘛。

第三个技巧，多用异常处理，但别滥用。Python的try-except是个好东西，但到处都是try就烦人了。该判断的用if，该捕获的用try。把可能出错的地方单独包起来，比整个函数套一个大try要清楚得多。

第四个技巧，列表推导式要克制。写 [x for x in items if x > 0] 很爽，但要是里面套三层循环加两个条件，没人看得懂。简单的一层推导式没问题，复杂了就老实写for循环，清晰比炫技重要。

第五个技巧，常量用全大写。项目里有些固定值，比如超时时间、重试次数、路径前缀，写成 MAX_RETRIES 或者 DEFAULT_TIMEOUT 这样。别人一看就知道是常量，不会乱改。我还见过有人把配置硬编码在函数里，改一次要翻遍整个文件，太痛苦。

第六个技巧，写注释要写为什么，不写是什么。代码本身就是表达“是什么”的，注释再写一遍就是废话。注释要解释当初为什么这么设计，比如“这里用缓存是因为数据库查询太慢，试过直接查，两秒才返回”。这种信息对后来的人太重要了。

第七个技巧，测试要写在代码旁边。别把测试放到单独目录就觉得完事了。每个函数写完，立刻写个测试用例，放在同一个文件底部或者相邻的test文件里。这样别人看代码的时候就能看到预期行为，比看说明书管用。

这些技巧不是我发明的，是很多老前辈踩坑踩出来的。写代码这事，跟写小说一个道理，先把话说清楚，再谈修辞。你的代码是给人读的，不是给机器看的。机器只在乎能不能跑，人更在乎能不能懂。

我见过团队里有人代码写花里胡哨的，各种装饰器、元类、动态生成，结果出了问题没人敢动。反过来，代码写得朴素的人，大家改起来都放心。好代码不是写得巧妙，是写得让人看得快。

你下次写代码的时候，试着拿这些标准看看自己的代码。变量看得懂吗，函数短不短，异常处理干净不干净，注释有没有解释原因，测试齐不齐。这几关过了，你的代码八成已经很好读了。

更多相关技术内容咨询欢迎前往并持续关注好学星城论坛了解详情。

想高效系统的学习Python编程语言，推荐大家关注一个微信公众号：Python编程学习圈。每天分享行业资讯、技术干货供大家阅读，关注即可免费领取整套Python入门到进阶的学习资料以及教程，感兴趣的小伙伴赶紧行动起来吧。

0 条评论