本章假定你已经阅读过上一篇教程。本章的所有内容在 Python 3.11.1 32x for Windows 下实现,不同的环境可能会有差异。
本章将讲述 Python 基本的编写规范和规律以及语法特点。
注释
繁多的脚本和复杂的代码容易使代码的可读性变差,因此标注特定的注释是必要的。在 Python 中,通常包含两种注释:单行注释和多行注释。
注释
单行注释
在 Python 中,使用"#"(Shift+3)启动单行注释。从"#"开始直至换行的内容都会被认为是注释。
# 我是一行注释
单行注释也可以插入在某段代码的后方,例如:
print('Hello World') # 输出内容
但这样是不对的:
print#输出内容('Hello World')
多行注释
使用三引号(三个连续的单引号)或三个连续的双引号启动多行注释。例如:
''' encoding: UTF-8
Author: Martin
Date: 2024-06-14
Type: Program
Thanks for using!
'''
三引号既可以作为多行注释,也可以作为字符串。解析器会自行区分,一般不用特别担心这两者被混淆。
缩进
Python 不像 Java 或者 C 语言那样采用"{}"分隔代码块,而是使用":"和缩进区分代码之间的关系和层次。
在 Python 中,可以按一下 Tab 来缩进一级。
一个缩进较复杂的例子:
def Cal(value,loop):
'''Internal function'''
try:
value = int(value)
loop = int(loop)
except ValueError:
print('Pls input int')
else:
for i in range(1,loop):
value = value + loop
if value % 2 == 0:
print('Catched')
break
else:
pass
if __name__ == '__main__':
Cal(2,200)
Python 对代码的缩进十分敏感。下方就是一个错误的例子:
编写规范
Python 使用 PEP 8(Python Enhancement Proposal,Python 增强建议)作为编写规范。"PEP 8"中的"8"表示版本号。下方是一些建议你在编写 Python 时遵守的编写规范。
模块导入
每个 import 语法应一次只导入一个模块。
建议写法:
import os
import shutil
不建议写法:
import os, shutil
如果需要导入的模块子功能过多时,建议使用括号将其分行显示:
建议写法:
from tkinter.ttk import (Label,Button,Entry,Radiobutton,Checkbutton,Separator,
Labelframe,Treview,Text)
不建议写法:
from tkinter.ttk import (Label,Button,Entry,Radiobutton,Checkbutton,Separator,Labelframe,Treview,Text)
不用分号
虽然可以这么做,但 Python 不是 CSS,不建议你在每行的最后添加分号";",也不要用分号将多行并为一行。
命名规范
- 类(class)名使用首字母大写的形式,如:
class MainPlayer(object):
def __init__(self):
# 省略此处代码
def move(self):
# 省略此处代码
class FireBall(object):
def __init__(self):
# 省略此处代码
def move(self):
# 省略此处代码
class CommonAttack(object):
# 省略此处代码
- 全局变量全部使用大写字母,可以使用下划线
- 函数、变量等内容使用小写+下划线的形式命名
- 模块内部的定义、类在前面加上下划线,例如:
def _join(value):
# 我是一个模块的内部定义,我一般只用于模块的内部运行,不会被用户使用
# 省略此处代码
def join(value):
# 省略此处代码
_join(value)
# 我是一个正式的定义,用户可以使用我