代码阅读约定

读者在阅读书中代码时,会看到一些带有编号的注释,笔者会在代码解释部分讲解这些注释所指向的代码行或代码片段。下面举一个例子。

class Window(QWidget):
    def __init__(self):
        super(Window, self).__init__()
        self.label = QLabel('你好世界!')
        self.btn = QPushButton('改变文本')
        self.btn.clicked.connect(self.change_text)      # 1
 
        v_layout = QVBoxLayout()                        #注释2开始
        v_layout.addWidget(self.label)
        v_layout.addWidget(self.btn)
        self.setLayout(v_layout)                        #注释2结束
 
    def change_text(self):                              # 3
        print('槽函数启动')
        self.label.setText('你好PyQt!')

代码解释:

#1 笔者会在这里解释注释#1所指向的代码行。

#2 笔者会在这里解释注释#2所指向的代码片段。

#3 笔者会在这里解释注释#3所指向的函数,就是解释函数中的代码。

除了上面这一约定外,本书第2章开始会默认省略导入代码和程序启动代码,除非特意写出。这样做是为了防止代码冗余。了解这两点代码阅读约定会更有助于读者理解本书内容。