1.1 项目背景与意义
骰子是生活中常见的随机博弈工具，广泛应用于棋牌游戏、娱乐互动等场景。在编程学习中，投骰子模拟是非常经典的入门级实战项目，它既涵盖了Python基础语法、随机数生成、循环结构、用户交互等核心知识点，又能直观体现编程解决实际问题的逻辑，非常适合初学者巩固知识、提升编程思维。
本项目将通过Python实现一个功能完整的投骰子模拟程序，支持单骰子、双骰子投掷，记录投掷结果、统计点数分布、实现多轮游戏交互，同时兼顾代码的可读性、扩展性和实用性。通过完整的代码编写、调试与分析，学习者可以掌握随机数模块使用、流程控制、数据统计、用户输入处理等实用技能，为后续开发更复杂的游戏或数据模拟项目打下基础。
1.2 项目功能需求
结合实用性与学习价值，本项目设定以下核心功能：
1. 支持用户选择单骰子或双骰子投掷模式；
2. 随机生成符合真实骰子规则的点数（1-6）；
3. 实时展示每一轮投掷结果；
4. 支持连续多次投掷，无需重复启动程序；
5. 统计总投掷次数、各点数出现次数及频率；
6. 友好的用户交互界面，支持退出游戏功能；
7. 异常处理，避免用户非法输入导致程序崩溃。
1.3 核心技术选型
本项目基于Python原生语法实现，无需第三方库，核心依赖以下技术：
1. random 模块：用于生成随机整数，模拟骰子投掷的随机性；
2. 条件判断（if-elif-else）：实现模式选择、功能分支控制；
3. 循环结构（while）：实现连续投掷、程序持续运行；
4. 字典/列表：用于存储点数统计数据，实现数据记录与分析；
5. 异常捕获（try-except）：处理用户非数字输入，提升程序健壮性；
6. 函数封装：将核心功能模块化，提升代码可读性与复用性。
二、完整项目代码实现
python
# 导入随机数模块
import random
def roll_single_dice():
"""
模拟单颗骰子投掷
返回值：1-6之间的随机整数
"""
return random.randint(1, 6)
def roll_double_dice():
"""
模拟两颗骰子投掷
返回值：包含两个骰子点数的元组
"""
dice1 = random.randint(1, 6)
dice2 = random.randint(1, 6)
return dice1, dice2
def print_statistics(stats, total_times, mode):
"""
打印骰子点数统计信息
:param stats: 存储点数统计的字典
:param total_times: 总投掷次数
:param mode: 投掷模式（单骰子/双骰子）
"""
print("\n==================== 投掷统计 ====================")
print(f"总投掷次数：{total_times}次")
print(f"当前模式：{mode}")
print("--------------------------------------------------")
if mode == "单骰子":
for point in range(1, 7):
count = stats.get(point, 0)
frequency = count / total_times * 100 if total_times > 0 else 0
print(f"点数 {point}：出现 {count} 次，频率 {frequency:.2f}%")
else:
for point, count in stats.items():
frequency = count / total_times * 100 if total_times > 0 else 0
print(f"点数和 {point}：出现 {count} 次，频率 {frequency:.2f}%")
print("==================================================\n")
def dice_game():
"""
投骰子游戏主函数，控制整体流程
"""
# 初始化统计变量
single_stats = {1:0, 2:0, 3:0, 4:0, 5:0, 6:0} # 单骰子统计
double_stats = {} # 双骰子点数和统计
total_times = 0
current_mode = None
print("============= Python投骰子模拟游戏 =============")
print("欢迎使用骰子模拟程序！")
print("1. 单骰子投掷")
print("2. 双骰子投掷")
print("3. 退出游戏")
print("===============================================\n")
while True:
# 获取用户选择
try:
choice = int(input("请输入您的选择（1/2/3）："))
except ValueError:
print("输入错误！请输入数字1、2或3\n")
continue
# 处理用户选择
if choice == 3:
print("\n游戏结束！感谢使用！")
# 退出前打印最终统计
if total_times > 0:
print_statistics(
single_stats if current_mode == "单骰子" else double_stats,
total_times,
current_mode
)
break
elif choice not in (1, 2):
print("无效选择！请重新输入1、2或3\n")
continue
else:
# 设置投掷模式
current_mode = "单骰子" if choice == 1 else "双骰子"
print(f"\n已切换至【{current_mode}】模式，输入任意字符开始投掷，输入q返回主菜单")
# 子循环：当前模式下连续投掷
while True:
user_input = input("\n按回车投掷骰子（输入q返回）：")
if user_input.lower() == 'q':
print("\n返回主菜单...\n")
break
# 执行投掷
total_times += 1
if choice == 1:
point = roll_single_dice()
single_stats[point] += 1
print(f"投掷结果：【{point}】")
else:
d1, d2 = roll_double_dice()
sum_point = d1 + d2
# 更新双骰子统计
double_stats[sum_point] = double_stats.get(sum_point, 0) + 1
print(f"投掷结果：骰子1={d1}，骰子2={d2}，点数和={sum_point}")
# 实时打印本轮统计
print_statistics(
single_stats if choice == 1 else double_stats,
total_times,
current_mode
)
# 启动游戏
if __name__ == "__main__":
dice_game()
三、代码逐模块深度解析
3.1 模块导入与基础配置
代码首行 import random 是项目的核心依赖， random 是Python内置的随机数模块，无需额外安装，其中 randint(a, b) 函数可生成 [a, b] 范围内的整数，完美匹配骰子1-6的点数规则。
这一步是所有随机模拟类程序的基础，若缺少该模块，程序无法实现随机投掷效果，只能生成固定点数，失去骰子模拟的意义。
3.2 单骰子投掷函数：roll_single_dice()
该函数是无参函数，功能单一且清晰：
python
def roll_single_dice():
return random.randint(1, 6)
1. 函数定义：使用 def 关键字定义函数，函数名直观体现功能，符合Python命名规范；
2. 核心逻辑：调用 random.randint(1, 6) 生成1到6的随机整数，模拟真实骰子投掷；
3. 返回值：将生成的随机点数返回，供主程序调用获取结果。
该函数体现了模块化编程思想，将单骰子投掷逻辑独立封装，后续若需修改骰子规则（如增加面数），只需修改此函数，不影响其他代码。
3.3 双骰子投掷函数：roll_double_dice()
python
def roll_double_dice():
dice1 = random.randint(1, 6)
dice2 = random.randint(1, 6)
return dice1, dice2
1. 功能扩展：在单骰子基础上，生成两个独立的随机点数，模拟两颗骰子同时投掷；
2. 返回值：以元组形式返回两个点数，方便主程序分别获取或计算点数和；
3. 独立性：两颗骰子的随机数生成相互独立，符合真实物理骰子的投掷规则，保证随机性公平。
双骰子模式增加了项目复杂度，同时也引入了数据组合的逻辑，为后续点数和统计奠定基础。
3.4 统计信息打印函数：print_statistics()
该函数是项目的数据展示核心，负责格式化输出投掷统计结果：
1. 参数设计：接收统计字典、总次数、投掷模式三个参数，适配单/双骰子两种场景；
2. 单骰子统计：遍历1-6固定点数，计算出现次数与频率，频率保留两位小数提升可读性；
3. 双骰子统计：遍历动态字典（点数和范围2-12），使用 dict.get() 方法避免键不存在报错；
4. 格式优化：通过分隔线、缩进、换行实现清晰的界面排版，提升用户体验。
此函数体现了代码复用性，避免在主程序中重复编写打印逻辑，同时让主程序逻辑更简洁。
3.5 主游戏函数：dice_game()
这是程序的核心控制模块，统筹整个游戏流程，可分为以下子逻辑：
（1）变量初始化
python
single_stats = {1:0, 2:0, 3:0, 4:0, 5:0, 6:0}
double_stats = {}
total_times = 0
current_mode = None
- single_stats ：字典存储单骰子各点数出现次数，初始值为0；
- double_stats ：空字典动态存储双骰子点数和的出现次数，适配2-12的可变范围；
- total_times ：记录总投掷次数，用于计算频率；
- current_mode ：标记当前投掷模式，方便统计展示。
（2）用户交互界面
通过 print 语句输出清晰的菜单指引，降低用户使用门槛，符合人性化交互设计原则。
（3）主循环与异常处理
python
while True:
try:
choice = int(input("请输入您的选择（1/2/3）："))
except ValueError:
print("输入错误！请输入数字1、2或3\n")
continue
- while True ：实现无限循环，让程序持续运行，直到用户选择退出；
- try-except ：捕获用户非数字输入的异常，避免程序直接崩溃，提升程序健壮性；
- 异常处理是实战项目的必备环节，日常学习中易被忽略，但在实际应用中至关重要。
（4）功能分支控制
通过 if-elif-else 判断用户选择，分别处理退出、单骰子、双骰子逻辑，实现功能解耦。
（5）连续投掷子循环
在选定模式后，嵌套 while 循环实现连续投掷，用户按回车即可投掷，输入 q 返回主菜单，操作便捷。
（6）数据更新与展示
每次投掷后，自动更新统计字典与总次数，并实时调用打印函数展示最新数据，实现实时反馈。
3.6 程序入口
python
if __name__ == "__main__":
dice_game()
这是Python程序的标准入口写法，确保代码仅在直接运行时执行，若被当作模块导入，不会自动启动游戏，符合模块化设计规范。
四、项目运行流程与效果说明
4.1 启动程序
运行代码后，首先展示主菜单，提示用户选择1（单骰子）、2（双骰子）、3（退出）。
4.2 模式选择与投掷
- 选择1：进入单骰子模式，按回车投掷，实时显示点数与统计；
- 选择2：进入双骰子模式，显示两颗骰子各自点数及总和，统计点数和分布；
- 输入非数字或无效数字：程序提示错误，重新等待输入，不崩溃。
4.3 数据统计展示
每投掷一次，程序自动计算各点数出现次数与频率，单骰子频率会趋近于16.67%（1/6），双骰子点数和7的频率最高，符合概率学规律。
4.4 退出程序
选择3或在投掷模式输入 q 返回主菜单后选择退出，程序打印最终统计结果并结束。
五、项目核心知识点总结与拓展
5.1 核心知识点复盘
1. 随机数生成：掌握 random.randint() 的使用，理解随机模拟的原理；
2. 函数封装：学会将独立功能封装为函数，提升代码复用性与可读性；
3. 流程控制：熟练运用 while 循环、 if-else 分支，实现复杂流程逻辑；
4. 数据结构：使用字典存储统计数据，掌握字典遍历、取值方法；
5. 异常处理：通过 try-except 处理用户输入异常，提升程序稳定性；
6. 用户交互：设计友好的输入输出界面，实现人性化交互。
5.2 项目拓展方向
本项目可基于现有代码进行升级，适合进阶学习：
1. 增加多骰子模式（3颗及以上）；
2. 实现骰子博弈游戏，如比大小、赌点数；
3. 将统计数据保存为Excel或文本文件；
4. 增加图形化界面（使用tkinter库）；
5. 模拟概率实验，验证大数定律。
六、项目实战价值总结
本次投骰子模拟项目虽代码量不大，但涵盖了Python入门到实战的核心逻辑，是连接基础语法与实际应用的桥梁。通过完整的代码编写与分析，学习者不仅掌握了随机数、循环、函数、异常处理等语法知识，更培养了需求分析、模块化设计、问题调试、用户交互的编程思维。
该项目可直接运行，兼具娱乐性与学习性，既可以作为课堂实战作业，也可以作为个人练手项目。后续在此基础上进行拓展，还能开发出更复杂的游戏或数据模拟程序，为Python学习之路打下坚实的实践基
