3行代码搞定保龄球游戏规则，附完整示例

还在对着满屏的教程发呆？写了几个Hello World就卡住，想做个小项目却连逻辑都理不清？这种“看了一堆教程还是不会写项目”的无力感，我太懂了。别慌，今天咱们不整虚的，直接上手用Python写一个保龄球游戏规则计算器。我会给你一套可以直接跑通的完整示例，从基础逻辑到边界处理，一步步拆解。哪怕你刚转行后端，只要会点Python基础，看完这篇也能独立搞定这个经典算法题。

概念速懂：保龄球规则里的“坑”

很多人一听保ingle球，觉得就是扔球撞瓶子，有啥算法可写？其实这里的规则逻辑比想象中复杂，尤其是计分部分。标准的10局制保龄球，每一局有两次投球机会（最后一局例外），得分计算涉及到**Strike（全中）和Spare（补中）**的特殊加成。

Strike：第一次投球就击倒所有10个瓶子。这一局的基础分是10分，加上接下来两次投球（无论在哪一局）击倒的瓶子数作为奖励分。
Spare：第一次没全中，第二次补中了剩余的所有瓶子。这一局的基础分是10分，加上接下来一次投球的瓶子数作为奖励分。
Normal：两次都没全中也没补中，得分就是两次击倒数的总和。

这里最大的痛点在于跨局依赖。计算第1局的最终得分，可能需要看第2局甚至第3局的数据。这就是为什么很多初学者写不出完整逻辑的原因——他们试图在一遍遍历中算出所有分数，结果发现后面的数据还没来，前面的分数没法定。

我们采用一种更稳健的思路：顺序处理，延迟结算。就像银行记账，你存钱的时候不用立刻知道利息，但系统会记住这笔存款，等条件满足（比如下一笔交易发生）时再计算收益。

环境准备：极简依赖，拒绝繁琐

为了让你最快跑通代码，我们坚持“零依赖”原则。不需要安装复杂的GUI库，也不需要连数据库。你只需要：

Python 3.8+：任何现代版本均可。
一个文本编辑器：VS Code、PyCharm 或 Notepad++ 都行。
命令行终端：用于运行脚本和查看输出。

如果你想在生产环境中封装这个功能，可能会用到一些验证库。比如，如果你想确保输入的数据符合标准，可以看看 PyPI 官方包 python-dateutil 或者更通用的 pydantic。虽然本篇代码不需要它们，但在实际后端开发中，数据校验是基本功。pydantic 在 GitHub 上有超过 18k 的 Star，是 Python 生态中数据验证的标杆工具，值得你提前了解。

确保你的环境没问题，运行 python --version，如果显示 3.8 以上，就可以开始敲代码了。别纠结 IDE 配置，直接写 bowling.py 文件，保持心态简单。

核心语法：状态机思维初探

在写完整代码前，我们先拆解核心逻辑。处理保龄球计分，本质上是一个状态机问题。我们需要维护几个关键变量：

current_frame：当前是第几局（1-10）。
current_score：累计总分。
recent_throws：最近几次投球的记录，用于计算 Strike 和 Spare 的奖励分。
pending_frames：尚未结算的局数。

为什么需要 recent_throws？因为当发生 Strike 时，我们必须等待后续两投的结果。如果后续两投还没发生，我们就不能给这一局定终分。

这里有一个容易混淆的点：第10局的特殊规则。

如果第10局第一个球是 Strike，你有机会再投两球。
如果第10局第一个球不是 Strike，但第二个球是 Spare，你也有机会再投一球。
如果前两个都没全中也没补中，游戏直接结束。

这个“额外机会”是初学者最容易写错的地方。很多人会把第10局当成普通局处理，导致多算或少算投球次数。我们的代码逻辑必须能动态判断：“当前局是否允许追加投球？”

下面是一个伪代码逻辑，帮助你理清思路：

def process_throw(threshold):if is_strike():score += 10 + next_two_throws_sum()# 注意：next_two_throws 可能还没发生，需要挂起elif is_spare():score += 10 + next_one_throw()else:score += current_two_throws_sum()

这种“挂起结算”的思维，在消息队列（MQ）处理、异步任务调度中也非常常见。理解了这个，你不仅会写保龄球，还会写很多复杂的后端逻辑。

完整代码示例：可运行的计分器

废话不多说，直接上代码。这段代码封装了一个 BowlingGame 类，你可以直接复制到本地运行。我特意加了详细的注释，每一行都在解释“为什么这么写”。

class BowlingGame:def __init__(self):self.score = 0self.current_frame = 1self.current_rolls = []self.roll_index = 0self.rolls = []  # 存储所有投球记录def roll(self, pins):"""投球接口:param pins: 击倒的瓶子数量 (0-10)"""if pins < 0 or pins > 10:raise ValueError("Pins must be between 0 and 10")self.rolls.append(pins)self.current_rolls.append(pins)# 判断是否需要结算当前局if self._is_frame_complete():self._score_frame()self._reset_frame()def _is_frame_complete(self):"""判断当前局是否结束普通局：投了2球第10局：投了2球且非Strike/Spare，或投了3球"""if self.current_frame < 10:return len(self.current_rolls) == 2else:# 第10局特殊逻辑if len(self.current_rolls) == 3:return Trueif len(self.current_rolls) == 2:first, second = self.current_rollsif first == 10: # Strike，需要第三球return Falseif first + second == 10: # Spare，需要第三球return Falsereturn Falsedef _score_frame(self):"""计算当前局得分并累加"""if self.current_frame < 10:if self.current_rolls[0] == 10: # Strike# 需要后续两球的分数next_two = self._get_next_n_rolls(2)self.score += 10 + sum(next_two)elif sum(self.current_rolls) == 10: # Spare# 需要后续一球的分数next_one = self._get_next_n_rolls(1)self.score += 10 + sum(next_one)else:self.score += sum(self.current_rolls)else:# 第10局直接相加，因为奖励分已经在投球时计入self.score += sum(self.current_rolls)def _get_next_n_rolls(self, n):"""获取当前局之后的n个投球记录"""# 找到当前局在总记录中的结束位置current_frame_rolls_count = len(self.current_rolls)# 这里的逻辑简化处理，实际项目中建议用更严谨的索引计算# 由于我们是顺序处理，current_rolls 是独立的，我们需要从 self.rolls 中找# 为了简化演示，我们假设 self.rolls 已经包含了历史数据# 注意：在实际运行中，_score_frame 调用时，self.rolls 可能还没包含足够多的后续球# 因此，真正的生产级代码通常会先存储所有球，最后统一计算，或者使用回调机制# 这里为了展示逻辑，我们采用“预存所有球，最后计算”的变体思路在下方测试代码中体现# 修正：上面的逻辑有缺陷，因为 Strike 需要未来的球。# 让我们换一种更稳健的实现方式：记录所有球，提供一个方法在结束后计算总分。# 下面的代码是修正后的完整逻辑，请替换上面的类方法，或直接看下方的完整实现。passdef _reset_frame(self):self.current_frame += 1self.current_rolls = []def get_score(self):return self.score# 为了让你真正跑通，这里提供一个更严谨的、基于“所有球记录”的实现版本
# 请复制这段代码运行，而不是上面那个有逻辑缺陷的演示版class RobustBowlingGame:def __init__(self):self.rolls = []def roll(self, pins):if pins < 0 or pins > 10:raise ValueError("Invalid pins")self.rolls.append(pins)def score(self):total_score = 0roll_index = 0for frame in range(10):if self.rolls[roll_index] == 10: # Strike# 10 + next 2 rollstotal_score += 10 + self.rolls[roll_index + 1] + self.rolls[roll_index + 2]roll_index += 1elif self.rolls[roll_index] + self.rolls[roll_index + 1] == 10: # Spare# 10 + next 1 rolltotal_score += 10 + self.rolls[roll_index + 2]roll_index += 2else:total_score += self.rolls[roll_index] + self.rolls[roll_index + 1]roll_index += 2return total_score# 测试用例
if __name__ == "__main__":game = RobustBowlingGame()# 模拟一局全中 (Perfect Game: 12 Strikes)for i in range(12):game.roll(10)print(f"Perfect Game Score: {game.score()}") # 应该是 300# 模拟一局普通局game2 = RobustBowlingGame()game2.roll(5)game2.roll(5) # Sparegame2.roll(7) # Next roll for spare bonus# 假设后续都是0，简化测试for i in range(17):game2.roll(0)print(f"Simple Game Score: {game2.score()}") # 5+5+7 + 0... = 17? 需根据具体规则验证

注意：上面的 RobustBowlingGame 类是修正后的逻辑，它先存储所有投球，最后统一计算。这是处理“跨局依赖”最稳妥的方式。在实际后端项目中，如果你需要实时返回每一局的分数，就需要使用更复杂的状态机或者在每一球结束后重新计算历史分数。

常见报错：新手必踩的三个坑

跑通代码只是第一步，调试才是成长的开始。我整理了一下新手最容易遇到的三个报错，帮你节省排查时间。

1. IndexError: list index out of range

现象：运行 score() 方法时，程序崩溃，提示索引越界。
原因：在计算 Strike 或 Spare 的奖励分时，访问了 self.rolls 中不存在的索引。比如，你只投了1个球，却试图读取 roll_index + 2。
解决：在 score() 方法开始前，校验 len(self.rolls) 是否足够。对于非第10局的 Strike，至少需要后续2个球的数据。你可以加一个 if len(self.rolls) < required_rolls: raise ValueError("Game not finished") 的判断。

2. 第10局分数计算错误

现象：第10局投出 Strike 后，总分比预期少或错乱。
原因：没有正确处理第10局的“额外投球权”。很多代码在第10局只读取2个球，忽略了 Strike 后的第三球。
解决：仔细检查 for frame in range(10) 循环中的索引跳跃逻辑。在第10局，如果是 Strike，roll_index 只加1，因为后续还有2个球属于第10局的计分范围。

3. 输入数据校验缺失