1、注释

  1. # 这是一个单行注释，一般会在#后留一个空格
  2. # 注释不是越多越好，简单的操作不需要注释
  3. # 不要描述代码，需要描述功能，如，print,需要为什们打印，不要描述 打印什么什么
  4. """
  5. 这是一个多行注释
  6. """
  7. print("hello world")
  9. # 打印函数：print() # 三引号 也可以用来表示字符串，保持字符串的格式如:
  10. value = """
  11. adfs
  12. sdfa
  13. sfs sdf
  14. """

2、书写格式

2.1、顶格开始书写

  1. print("hello world")
  2.  print("hello world python")  #必须顶格书写，否则报错

2.2、一条语句建议一行

  1. print("hello world") ; print("df")  #多条语句需要以;分开，建议一行一条语句
  2. > hello world
  3. > df

2.3、操作符空格

  1. # 在操作符两边留一个空格
  2. name = 2 * 3
  3. print(name)

2.4、函数规范

2.4.1、前后空两行

  1. def say():
  2.     print("hello world")
  4. #空两行
  5. say()

2.4.2、文档注释

  1. def sum_2(a, b):
  2.     """
  3.     两个数求和
  4.     :return:
  5.     :param a: 参数1
  6.     :param b: 参数2
  7.     :return: 两个数的和
  8.     """
  9.     return a + b
  11. # 写在函数名下面

2、包

image.png
每个包下必须要有一个init.py文件