写出整洁代码

整洁的代码的要求：

• 优雅且高效；直截了当；减少依赖；只做好一件事
• 简单直接
• 可读，可维护，单元测试
• 不要重复、单一职责，表达力（Expressiveness）

一. 命名的艺术

1.1 名副其实

好的变量名告诉你：是什么东西，为什么存在，该怎么使用

栗子：

# bad code
def getItem(theList):
   ret = []
   for x in theList:
      if x[0] == 4:
         ret.append(x)
   return ret

# good code
def getFlaggedCell(gameBoard):
   '''扫雷游戏，flagged： 翻转'''
   flaggedCells = []
   for cell in gameBoard:
      if cell.IsFlagged():
         flaggedCells.append(cell)
   return flaggedCells

1.2 概念的区分度

栗子：

# bad
def copy(a_list, b_list):
    pass

# good
def copy(source, destination):
    pass

注：source：源, destination：目的地

1.3 单词名称可读、方便搜索

注意
比如变量 temp 不直接

二. 注释

1. 以下一些情况属于好的注释

• 对意图的注释，为什么要这么做，函数的输入输出
• 警示
• 放大看似不合理之物的重要性

最坏的注释就是过时或者错误的注释

…

学习链接：
https://blog.csdn.net/jeffli1993/article/details/100883370