1、注释

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

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")
  3. #空两行
  4. 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
  10. # 写在函数名下面

2、包

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