Python 教程：初来乍到 - 基本（2）

 本章假定你已经阅读过上一篇教程。本章的所有内容在 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)
    #    我是一个正式的定义，用户可以使用我