Python入门实战：猜数字游戏完整代码

猜数字游戏是初学者检验编程语法的理想项目。游戏规则直截了当：计算机在指定区间内随机生成一个整数，玩家通过控制台不断输入猜测，程序根据输入给出“猜大了”或“猜小了”的即时提示，直至玩家准确命中目标，并输出累计尝试的次数。实现这样一个程序，能一次性串联起变量声明、随机数生成、循环控制、多分支判断以及异常防护等核心技术点。

一、程序主流程与运行机制

在开始编写代码前，先梳理清楚游戏在运行时的逻辑顺序。程序首先调用标准库生成目标数字并重置计数器，随后进入主循环等待输入。每一次输入都需要经历格式校验、有效计次以及大小比较三个步骤。一旦数值匹配，程序跳出循环完成结算；若不匹配，则打印提示信息并让玩家进入下一轮猜测。

二、基础版完整代码实现

下面是一份可以直接在 Python 3 环境下运行的单文件基础版本。该版本使用 random.randint() 生成 1 到 100 之间的随机数，并通过 while True 构建无限循环持续接收输入。

import random

def guess_number_basic():
    # 1. 确定目标随机数并初始化计数器
    target = random.randint(1, 100)
    count = 0
    
    print("【猜数字游戏】系统已生成 1 到 100 之间的整数，请开始猜测！")
    
    # 2. 游戏主循环
    while True:
        user_input = input("请输入你猜的数字：")
        
        # 转换输入类型为整数
        guess = int(user_input)
        count += 1
        
        # 3. 比较大小并给予反馈
        if guess > target:
            print("太大了，请尝试更小的数字！")
        elif guess < target:
            print("太小了，请尝试更大的数字！")
        else:
            print(f"恭喜你猜对了！目标数字就是 {target}。")
            print(f"你总共尝试了 {count} 次。")
            break

if __name__ == "__main__":
    guess_number_basic()

关键语法解析

• random.randint(1, 100)：该函数返回包含两端端点的随机整数，即生成的数字可能是 1、100 或两者之间的任意整数。与字符串切片或 range() 的左闭右开规则不同，这里是全闭区间。
• while True 与 break：游戏在玩家猜对前不知道具体要执行多少轮，使用无限循环配合内部的 break 语句是最自然的表达方式。一旦进入 else 分支，break 会立即终止整个循环。
• count += 1：在每次有效比较前自增 1，精准记录玩家消耗的步数。

三、程序分层架构与模块协作

尽管猜数字游戏的代码行数不多，但从工程结构上看，它清晰地包含了状态管理、输入拦截、决策推导和交互呈现四个层次。理清这些层级，有助于我们在后续为其增加异常处理、难度选择和重玩机制。

四、提升代码健壮性：异常处理与边界检查

基础版代码存在一个常见的运行时隐患：当用户误输入字母（如 abc）、浮点数（如 12.5）或直接敲击回车时，int(user_input) 会直接抛出 ValueError 异常导致程序崩溃退出。生产环境中必须对用户输入保持防御式编程思维。

我们可以使用 try...except ValueError 语句捕获非整型输入。此外，若输入的数字小于 1 或大于 100，虽然不会导致报错，但明显违背游戏规则，应当给出提示并且不计入有效猜测轮数：

while True:
    user_input = input("请输入 1 到 100 之间的整数：").strip()
    
    # 捕获非法输入类型
    try:
        guess = int(user_input)
    except ValueError:
        print("【错误】输入无效！请输入纯数字整数。")
        continue  # 跳过本轮循环，不增加 count
        
    # 检查数值范围
    if guess < 1 or guess > 100:
        print("【提示】数字超出范围，请输入 1 到 100 之间的数值！")
        continue

    # 经过上述校验后，再进行有效计次与比较
    count += 1
    ...

五、算法策略推导：二分查找的实际应用

猜数字游戏不仅是语法练习，也是理解二分查找算法（Binary Search）的最佳实例。如果玩家从 1 依序猜到 100（线性扫描），最差情况下需要尝试 100 次。但如果每次都选择当前可能区间的中间值，每猜测一次就能直接排除一半的错误数字。

对于范围为 1 到 100 的整数，由于 2^6 = 64 < 100 < 2^7 = 128，根据对数性质 ⌈log2(100)⌉ = 7，采用二分策略的玩家最多只需 7 次猜测即可百分之百锁定目标。

六、进阶实战：增加轮数限制与多局重玩

在掌握了基础实现与异常处理之后，我们可以将代码重构为一个功能完备的游戏模块。进阶版代码具备以下实用特性：

• 游戏函数封装：将单局游戏放入独立函数，避免全局变量污染。
• 猜测机会上限：设置最大尝试次数（例如 7 次），让游戏具备胜负挑战感。
• 多局调度循环：在单局结束后询问玩家是否再来一局，输入 y 重新开始，输入其他内容优雅退出。

import random

def play_one_game(max_attempts=7):
    """进行单局猜数字游戏"""
    target = random.randint(1, 100)
    attempts = 0
    
    print("\n" + "=" * 40)
    print(f"【新游戏开始】你有 {max_attempts} 次机会猜中 1 到 100 之间的数字！")
    print("=" * 40)
    
    while attempts < max_attempts:
        remaining = max_attempts - attempts
        raw_input = input(f"\n[剩余机会: {remaining}] 请输入你猜测的数字: ").strip()
        
        # 1. 拦截异常输入
        try:
            guess = int(raw_input)
        except ValueError:
            print("输入格式错误，必须是纯整数，本次不计入消耗。")
            continue
            
        # 2. 检查有效区间
        if guess < 1 or guess > 100:
            print("数字必须在 1 到 100 之间，本次不计入消耗。")
            continue
            
        # 3. 计次与比较
        attempts += 1
        if guess > target:
            print(f"偏大！目标比 {guess} 更小。")
        elif guess < target:
            print(f"偏小！目标比 {guess} 更大。")
        else:
            print(f"\n太棒了！你在第 {attempts} 次成功命中了目标数字 {target}！")
            return True
            
    # 超出机会判定为失败
    print(f"\n很遗憾，机会已用尽！本局目标数字其实是 {target}。")
    return False

def main():
    """主调度函数：支持反复游玩"""
    print("欢迎来到 Python 猜数字挑战！")
    
    while True:
        play_one_game(max_attempts=7)
        
        # 询问是否继续游戏
        choice = input("\n还要再玩一局吗？(输入 y 继续，其他键退出): ").strip().lower()
        if choice != 'y':
            print("感谢游玩，再见！")
            break

if __name__ == "__main__":
    main()

七、核心知识点全景总结

通过这篇简短实用的实战，初学者已经综合运用了 Python 的多项基础语法。下面将本项目涉及的知识体系梳理成表，方便在后续编程学习中随时查阅复习。

八、常见误区与避坑指南

1. 忘记将输入转换为数字：在 Python 3 中，input() 函数返回的内容永远是字符串（str）。如果直接执行 if guess > target:，解释器会抛出 TypeError: '>' not supported between instances of 'str' and 'int'。必须显式使用 int() 完成类型转换。
2. 计数器位置摆放不当：如果将 count += 1 放在 int() 转换之前，或者放在异常捕获之前，那么当用户不小心输错字母或敲入空格时，计数器也会增加。这会导致玩家被惩罚不合理的猜测机会。正确的做法是放在输入验证成功之后。
3. 把随机数生成写在循环内部：如果在 while 循环的第一行写入 target = random.randint(1, 100)，那么玩家每猜一次，目标数字都会变一次，游戏将几乎不可能通关。必须把 target 的生成置于循环体外部。