用Python写猜数字游戏：初学者第一个实战项目代码

一、游戏核心规则与运行流转设计

一个典型的猜数字游戏规则十分清晰：由计算机在指定的整数区间（如 1 到 100 之间）秘密随机生成一个目标数字；玩家在控制台输入猜测的值；计算机比对玩家输入与目标数值的大小，若猜大则提醒偏大，若猜小则提醒偏小；当玩家完全猜中时，程序汇报玩家累计的尝试次数，并结束本次游戏。

将人类的游戏意图转化为代码时，需要把过程拆解为有限且清晰的离散逻辑节点。下方的流转图展示了游戏从环境准备、循环接收输入、条件分流到退出程序的全生命周期。

从程序架构来看，这个小项目虽然轻量，却恰好连接了 Python 初学阶段最重要的三大结构：

• 顺序结构：导入必要模块、初始化秘密数字与计步计数器；
• 循环结构：因为无法预知玩家需要多少次才能猜中，必须使用 while 循环维持游戏交互状态；
• 分支结构：通过 if-elif-else 分别处理“大于”、“小于”与“等于”三种互斥结果。

二、基础版核心代码与分段拆解

我们先以最精简、无修饰的方式实现基础功能。完成这个阶段只需要掌握 Python 标准库中的 random 模块、接收输入的 input() 函数以及最基础的流程控制语句。

1. 依赖导入与生成目标数值

生成伪随机数不需要安装任何第三方扩展包，直接引入 Python 自带的 random 模块即可。

import random

# 生成 1 到 100 之间的随机整数（包含两端端点 1 和 100）
secret_number = random.randint(1, 100)
attempts = 0

2. 输入获取、类型转换与循环判定

在终端中，函数 input() 始终返回字符串类型（str）。计算机无法直接判断字符串 "50" 与整数 50 之间的大小关系。如果尝试直接比对，Python 解释器会抛出类型错误（TypeError: '>' not supported between instances of 'str' and 'int'）。因此必须使用内置函数 int() 对输入内容进行强制显式类型转换。

while True:
    user_input = input("请输入你猜的数字 (1-100): ")
    guess = int(user_input)
    attempts += 1

    if guess > secret_number:
        print("太大了，再猜小一点！")
    elif guess < secret_number:
        print("太小了，再猜大一点！")
    else:
        print(f"恭喜你，猜对了！目标数字就是 {secret_number}。")
        print(f"你总共尝试了 {attempts} 次。")
        break

在这段循环体内，while True 构建了一个无限循环。只有当 guess == secret_number 条件成立进入最后的 else 分支时，触发 break 语句，循环才会正式终止，程序顺畅向下执行直至完毕。

三、异常防御：处理非法输入与防崩溃改造

上述基础版代码在理想情况下运行良好，但在实际运行中，用户的行为往往是不可预测的。例如用户误触回车输入空内容，或者键入了字母 abc、汉字或标点符号。

此时执行 int("abc") 会立即触发 Python 内置的 ValueError 异常。如果代码中没有处理这个异常，程序会直接报错并在终端崩溃退出，之前所有累积的猜测进程全部丢失。

为了构建一个稳定健壮的程序，应当使用 try...except 结构将易出错的转换操作保护起来：

• 将 guess = int(user_input) 置于 try 代码块内；
• 紧跟 except ValueError: 分支，一旦发生类型解析失败，输出清晰友好的中文指引；
• 使用 continue 关键字直接跳过本轮循环的后续判定，重新回到循环开头等待玩家再次输入；
• 确保输入错误时不递增有效尝试计数器 attempts，保证统计数据的客观公正。

四、健壮版完整代码实现与运行验证

将异常防御机制、数值范围合理性检查以及计数统计融合在一起，便得到了最终的工程化标准代码。读者可以直接将以下完整源码保存为 guess_number.py 并在本地命令行中运行。

1. 完整可执行 Python 源码

# -*- coding: utf-8 -*-
"""
项目名称：Python 猜数字游戏实战
功能说明：生成 1-100 随机数，支持异常输入拦截与猜测次数统计
适用版本：Python 3.6 及以上
"""

import random


def play_game():
    secret_number = random.randint(1, 100)
    attempts = 0

    print("=" * 42)
    print("欢迎体验 Python 猜数字游戏！")
    print("我已经想好了一个 1 到 100 之间的整数。")
    print("=" * 42)

    while True:
        user_input = input("请输入你猜测的数字 (输入 q 退出): ").strip()

        # 预留主动退出通道
        if user_input.lower() == 'q':
            print(f"游戏提前结束，目标数字是：{secret_number}。下次加油！")
            break

        # 异常防范：确保转换为整数安全
        try:
            guess = int(user_input)
        except ValueError:
            print("【输入错误】请输入有效的阿拉伯整数！")
            continue

        # 业务范围过滤
        if guess < 1 or guess > 100:
            print("【超出范围】提示：猜测范围在 1 到 100 之间。")
            continue

        # 有效猜测计步
        attempts += 1

        # 核心大小比较逻辑
        if guess > secret_number:
            print(f"第 {attempts} 次尝试：{guess} 太大了，请往小猜。")
        elif guess < secret_number:
            print(f"第 {attempts} 次尝试：{guess} 太小了，请往大猜。")
        else:
            print("-" * 42)
            print(f"🎉 恭喜你猜中了！隐藏数字正是 {secret_number}。")
            print(f"你一共进行了 {attempts} 次有效猜测。")
            print("-" * 42)
            break


if __name__ == "__main__":
    play_game()

2. 控制台真实交互运行示例

在终端执行 python3 guess_number.py 后，控制台交互的输出记录如下所示（示例演示了非法字符拦截、范围越界提示与成功命中）：

五、核心知识体系提炼与进阶拓展

通过实现猜数字游戏，初学者实际上已经将 Python 编程中五个最核心的概念紧密协同使用。下图对本项目涉及的技术组件进行了全景结构梳理。

项目核心语法对照表

初学者进阶拓展练习

如果已经完全掌握了上述代码并能独立编写，建议尝试完成以下三项进阶功能拓展，进一步加深对数据结构与算法的理解：

1. 增加最大猜测次数限制：设置变量 max_attempts = 7。如果玩家在 7 次机会内未能猜中，提示“机会用尽，游戏失败”并公布正确答案。从算法角度看，在 1 到 100 的区间内，采用二分查找法最多只需 7 次必能猜中。
2. 动态收缩范围提示：在玩家输入太小或太大后，维护两个边界变量 low_bound 和 high_bound，在下一次提示中直接告知玩家当前有效范围（例如“提示：数字在 51 到 74 之间”）。
3. 身份反转（人出题电脑猜）：由玩家在心中想好一个数字，电脑通过二分查找逻辑每次打印出猜测值，玩家输入“大”、“小”或“对了”，体验计算机自动化查找算法的高效性。