写一个python的俄罗斯方块游戏带注释

好的，下面是一个简单的 Python 俄罗斯方块游戏，带有注释解释每个功能的作用：

import pygame
import random

# 初始化 pygame
pygame.init()

# 设置游戏界面大小及标题
width, height = 500, 600
screen = pygame.display.set_mode((width, height))
pygame.display.set_caption("俄罗斯方块")

# 定义方块大小及颜色
block_size = 20
white = (255, 255, 255)
black = (0, 0, 0)
colors = [(255, 0, 0), (0, 255, 0), (0, 0, 255), (255, 255, 0), (255, 0, 255), (0, 255, 255), (128, 128, 128)]

# 定义方块形状
shapes = [
    [[1, 1, 1],
     [0, 1, 0]],
    [[0, 2, 2],
     [2, 2, 0]],
    [[3, 3, 0],
     [0, 3, 3]],
    [[4, 0, 0],
     [4, 4, 4]],
    [[0, 0, 5],
     [5, 5, 5]],
    [[6, 6, 6, 6]],
    [[7, 7],
     [7, 7]]
]

# 定义游戏主循环
def run_game():
    # 初始化游戏区域
    board = [[0 for _ in range(10)] for _ in range(20)]
    
    # 定义当前方块及其位置
    current_shape = random.choice(shapes)
    current_color = random.choice(colors)
    current_row, current_col = 0, 5
    
    # 定义得分
    score = 0
    
    # 定义游戏结束标志
    game_over = False
    
    # 定义游戏循环
    while not game_over:
        # 处理游戏事件
        for event in pygame.event.get():
            if event.type == pygame.QUIT:
                game_over = True
            elif event.type == pygame.KEYDOWN:
                if event.key == pygame.K_LEFT:
                    # 左移方块
                    if is_valid_move(board, current_shape, current_row, current_col - 1):
                        current_col -= 1
                elif event.key == pygame.K_RIGHT:
                    # 右移方块
                    if is_valid_move(board, current_shape, current_row, current_col + 1):
                        current_col += 1
                elif event.key == pygame.K_DOWN:
                    # 快速下落方块
                    if is_valid_move(board, current_shape, current_row + 1, current_col):
                        current_row += 1
                    else:
                        # 方块落地后加入游戏区域
                        add_to_board(board, current_shape, current_row, current_col, current_color)
                        # 计算得分并更新游戏区域
                        score += clear_rows(board)
                        # 生成新的方块
                        current_shape = random.choice(shapes)
                        current_color = random.choice(colors)
                        current_row, current_col = 0, 5
                        # 判断游戏是否结束
                        if not is_valid_move(board, current_shape, current_row, current_col):
                            game_over = True
                
        # 绘制游戏界面
        screen.fill(white)
        draw_board(board)
        draw_shape(current_shape, current_row, current_col, current_color)
        draw_score(score)
        pygame.display.update()
        
        # 控制游戏帧率
        pygame.time.Clock().tick(5)
        
    # 退出游戏
    pygame.quit()

# 判断是否合法移动
def is_valid_move(board, shape, row, col):
    rows, cols = len(shape), len(shape[0])
    for i in range(rows):
        for j in range(cols):
            if shape[i][j] != 0:
                if row + i < 0 or row + i >= 20 or col + j < 0 or col + j >= 10 or board[row + i][col + j] != 0:
                    return False
    return True

# 将方块加入游戏区域
def add_to_board(board, shape, row, col, color):
    rows, cols = len(shape), len(shape[0])
    for i in range(rows):
        for j in range(cols):
            if shape[i][j] != 0:
                board[row + i][col + j] = color

# 判断并消除满行
def clear_rows(board):
    rows, cols = len(board), len(board[0])
    full_rows = []
    for i in range(rows):
        if 0 not in board[i]:
            full_rows.append(i)
    for row in full_rows:
        del board[row]
        board.insert(0, [0 for _ in range(cols)])
    return len(full_rows)

# 绘制游戏界面
def draw_board(board):
    rows, cols = len(board), len(board[0])
    for i in range(rows):
        for j in range(cols):
            pygame.draw.rect(screen, black, [j * block_size, i * block_size, block_size, block_size], 1)
            if board[i][j] != 0:
                pygame.draw.rect(screen, board[i][j], [j * block_size + 1, i * block_size + 1, block_size - 2, block_size - 2])

# 绘制方块
def draw_shape(shape, row, col, color):
    rows, cols = len(shape), len(shape[0])
    for i in range(rows):
        for j in range(cols):
            if shape[i][j] != 0:
                pygame.draw.rect(screen, color, [(col + j) * block_size + 1, (row + i) * block_size + 1, block_size - 2, block_size - 2])

# 绘制得分
def draw_score(score):
    font = pygame.font.Font(None, 30)
    text = font.render("Score: " + str(score), True, black)
    screen.blit(text, [0, height - 30])

# 启动游戏
run_game()

注释中解释了每个函数的作用，可以根据需要进行修改和优化。