端午粽香千年传：粽子文化溯源与Python包粽子模拟器实战开发

目录

• 1 引言：端午节与粽子的文化共生
• • 1.1 端午节的历史渊源
  • 1.2 粽子的文化象征
  • 1.3 非遗保护与文化传承
• 2 粽子的种类谱系与地域文化
• • 2.1 南北甜咸之争：饮食文化的地理分野
  • 2.2 地域特色粽子图谱
  • 2.3 少数民族粽子与海外传播
• 3 粽子制作工艺的传统智慧
• • 3.1 选料：粽叶、糯米与馅料
  • 3.2 包扎：折叠与缠绕的技艺
  • 3.3 煮制：火候与时间的艺术
• 4 Python模拟器的设计理念与技术架构
• • 4.1 设计理念：游戏化传承
  • 4.2 技术选型：Pygame框架
  • 4.3 架构设计：状态机模式
• 5 核心代码实现与原理解析
• • 5.1 初始化与字体加载
  • 5.2 游戏主循环
  • 5.3 粽子绘制算法
  • 5.4 评分系统
  • 5.5 交互反馈机制
• 6 模拟器的文化教育功能
• • 6.1 体验式学习理论
  • 6.2 文化情境的构建
  • 6.3 跨代际文化传递
  • 6.4 数字文化传承的范式
• 7 运行测试与部署
• • 7.1 环境配置
  • 7.2 测试验证
  • 7.3 跨平台兼容性
  • 6.1 工艺知识的显性化
  • 6.2 地域文化的展示
  • 6.3 节日氛围的营造
• 7 技术挑战与解决方案
• • 7.1 中文字体跨平台兼容
  • 7.2 无显示环境下的测试
  • 7.3 动画流畅度与性能
• 8 未来展望：数字技术赋能文化传承
• • 8.1 增强现实（AR）包粽子
  • 8.2 多人协作包粽子
  • 8.3 文化大数据的融入
  • 8.4 人工智能辅助
  • 8.5 结语：代码与文化的对话

博主智算菩萨，专注于人工智能、Python编程、音视频处理及UI窗体程序设计等方向。致力于以通俗易懂的方式拆解前沿技术，从零基础入门到高阶实战，陪伴开发者共同成长。目前已开设五大技术专栏，累计发布多篇原创技术文章，深受读者好评。

📌 专栏导航

• 人工智能前沿知识（已更191篇）：深度剖析Transformer架构、生成式AI、强化学习、具身智能、神经符号系统、大模型及智能体（Agent）技术，系统性解析AI核心技术体系与前沿趋势。
• Python基础小白编程（已更232篇）：从零开始，以保姆式教程讲解变量、数据类型、流程控制、函数等核心语法，配有大量实战代码与避坑指南，真正做到学以致用。
• 机器学习与深度学习（125篇）：系统化拆解线性模型、决策树、随机森林、梯度提升树、神经网络等算法原理与工程实践，覆盖从公式推导到代码实现的全链路内容。
• 音频、图像与视频处理理论与实战（81篇）：涵盖FFmpeg多媒体处理、audio_shop开源工具、ComfyUI-WanVideoWrapper视频生成等实用技术，从基础操作到高级应用一应俱全。
• UI窗体程序设计实战（78篇）：深入讲解UI设计、动态窗体生成、游戏UI框架设计等实战技巧，提供从配置到编码的完整解决方案。 智算菩萨，以代码为经，以算法为纬，在人工智能的星辰大海中，做你前行路上最可靠的导航者。本人最常用AI工具为AIGCBAR。

声明：本文作者认为，端午节粽子文化是中华文明"以食载道"的典型范式——一片粽叶包裹的不仅是糯米与馅料，更是两千余年的集体记忆与文化认同。用Python模拟包粽子过程，并非对传统的解构，而是以数字技术为载体，让年轻一代在交互体验中触摸文化根脉。技术赋能文化传承，代码亦可承载乡愁。

端午节（农历五月初五）是中国四大传统节日之一，2009年入选联合国教科文组织《人类非物质文化遗产代表作名录》，是中国首个入选世界非遗的节日。粽子作为端午节最具代表性的符号物，承载着从屈原传说到地域饮食文化的丰富内涵。本文将从粽子文化的历史溯源出发，系统梳理粽子的种类谱系、制作工艺与文化意蕴，并基于Python + Pygame框架开发一个交互式包粽子模拟器，以技术手段再现传统工艺，实现文化传承与数字创新的融合。

1 引言：端午节与粽子的文化共生

端午节与粽子的关系，是中华民俗文化中"节日-食物"共生模式的典型代表。理解这一共生关系，需要从节日起源、食物演变和文化象征三个维度进行考察。

1.1 端午节的历史渊源

端午节的起源众说纷纭，学界主要有以下几种学说。纪念屈原说是流传最广的说法，南朝吴均《续齐谐记》记载："屈原五月五日自投汨罗而死，楚人哀之，至此日以竹筒贮米投水祭之。"这一传说将端午节与战国时期楚国诗人屈原的投江殉国联系起来，赋予了节日忠君爱国的精神内涵。

然而，民俗学研究表明，端午节的起源远早于屈原。福州市人民政府刊载的民俗资料指出，粽子的最早文字记载出自东汉许慎的《说文解字》，食粽子习俗早于屈原去世400多年；西晋周处在《风土记》中称"于五月五日及夏至啖之"，可见古人夏至也吃粽子，并非端午专属。这一发现表明，粽子最初可能是夏至时令的食物，后来才与端午节和屈原传说融合。

此外，还有纪念伍子胥说（吴越地区）、纪念曹娥说（会稽地区）、恶月恶日驱邪说等多种起源学说。高丙中教授在《端午节是中国人的认同文化》中指出，端午节的多重起源反映了中国地域文化的多样性，而屈原传说的主流化则是文化整合与国家认同建构的结果。

#mermaid-svg-uRRSRUhjhUGYy5UB{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-uRRSRUhjhUGYy5UB .error-icon{fill:#552222;}#mermaid-svg-uRRSRUhjhUGYy5UB .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-uRRSRUhjhUGYy5UB .marker{fill:#333333;stroke:#333333;}#mermaid-svg-uRRSRUhjhUGYy5UB .marker.cross{stroke:#333333;}#mermaid-svg-uRRSRUhjhUGYy5UB svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-uRRSRUhjhUGYy5UB p{margin:0;}#mermaid-svg-uRRSRUhjhUGYy5UB .edge{stroke-width:3;}#mermaid-svg-uRRSRUhjhUGYy5UB .section–1 rect,#mermaid-svg-uRRSRUhjhUGYy5UB .section–1 path,#mermaid-svg-uRRSRUhjhUGYy5UB .section–1 circle,#mermaid-svg-uRRSRUhjhUGYy5UB .section–1 path{fill:hsl(240, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .section–1 text{fill:#ffffff;}#mermaid-svg-uRRSRUhjhUGYy5UB .node-icon–1{font-size:40px;color:#ffffff;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-edge–1{stroke:hsl(240, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-depth–1{stroke-width:17;}#mermaid-svg-uRRSRUhjhUGYy5UB .section–1 line{stroke:hsl(60, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-uRRSRUhjhUGYy5UB .lineWrapper line{stroke:#ffffff;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled circle,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:lightgray;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:#efefef;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-0 rect,#mermaid-svg-uRRSRUhjhUGYy5UB .section-0 path,#mermaid-svg-uRRSRUhjhUGYy5UB .section-0 circle,#mermaid-svg-uRRSRUhjhUGYy5UB .section-0 path{fill:hsl(60, 100%, 73.5294117647%);}#mermaid-svg-uRRSRUhjhUGYy5UB .section-0 text{fill:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .node-icon-0{font-size:40px;color:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-edge-0{stroke:hsl(60, 100%, 73.5294117647%);}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-depth-0{stroke-width:14;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-0 line{stroke:hsl(240, 100%, 83.5294117647%);stroke-width:3;}#mermaid-svg-uRRSRUhjhUGYy5UB .lineWrapper line{stroke:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled circle,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:lightgray;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:#efefef;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-1 rect,#mermaid-svg-uRRSRUhjhUGYy5UB .section-1 path,#mermaid-svg-uRRSRUhjhUGYy5UB .section-1 circle,#mermaid-svg-uRRSRUhjhUGYy5UB .section-1 path{fill:hsl(80, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .section-1 text{fill:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .node-icon-1{font-size:40px;color:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-edge-1{stroke:hsl(80, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-depth-1{stroke-width:11;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-1 line{stroke:hsl(260, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-uRRSRUhjhUGYy5UB .lineWrapper line{stroke:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled circle,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:lightgray;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:#efefef;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-2 rect,#mermaid-svg-uRRSRUhjhUGYy5UB .section-2 path,#mermaid-svg-uRRSRUhjhUGYy5UB .section-2 circle,#mermaid-svg-uRRSRUhjhUGYy5UB .section-2 path{fill:hsl(270, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .section-2 text{fill:#ffffff;}#mermaid-svg-uRRSRUhjhUGYy5UB .node-icon-2{font-size:40px;color:#ffffff;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-edge-2{stroke:hsl(270, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-depth-2{stroke-width:8;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-2 line{stroke:hsl(90, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-uRRSRUhjhUGYy5UB .lineWrapper line{stroke:#ffffff;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled circle,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:lightgray;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:#efefef;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-3 rect,#mermaid-svg-uRRSRUhjhUGYy5UB .section-3 path,#mermaid-svg-uRRSRUhjhUGYy5UB .section-3 circle,#mermaid-svg-uRRSRUhjhUGYy5UB .section-3 path{fill:hsl(300, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .section-3 text{fill:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .node-icon-3{font-size:40px;color:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-edge-3{stroke:hsl(300, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-depth-3{stroke-width:5;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-3 line{stroke:hsl(120, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-uRRSRUhjhUGYy5UB .lineWrapper line{stroke:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled circle,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:lightgray;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:#efefef;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-4 rect,#mermaid-svg-uRRSRUhjhUGYy5UB .section-4 path,#mermaid-svg-uRRSRUhjhUGYy5UB .section-4 circle,#mermaid-svg-uRRSRUhjhUGYy5UB .section-4 path{fill:hsl(330, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .section-4 text{fill:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .node-icon-4{font-size:40px;color:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-edge-4{stroke:hsl(330, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-depth-4{stroke-width:2;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-4 line{stroke:hsl(150, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-uRRSRUhjhUGYy5UB .lineWrapper line{stroke:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled circle,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:lightgray;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:#efefef;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-5 rect,#mermaid-svg-uRRSRUhjhUGYy5UB .section-5 path,#mermaid-svg-uRRSRUhjhUGYy5UB .section-5 circle,#mermaid-svg-uRRSRUhjhUGYy5UB .section-5 path{fill:hsl(0, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .section-5 text{fill:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .node-icon-5{font-size:40px;color:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-edge-5{stroke:hsl(0, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-depth-5{stroke-width:-1;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-5 line{stroke:hsl(180, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-uRRSRUhjhUGYy5UB .lineWrapper line{stroke:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled circle,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:lightgray;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:#efefef;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-6 rect,#mermaid-svg-uRRSRUhjhUGYy5UB .section-6 path,#mermaid-svg-uRRSRUhjhUGYy5UB .section-6 circle,#mermaid-svg-uRRSRUhjhUGYy5UB .section-6 path{fill:hsl(30, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .section-6 text{fill:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .node-icon-6{font-size:40px;color:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-edge-6{stroke:hsl(30, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-depth-6{stroke-width:-4;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-6 line{stroke:hsl(210, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-uRRSRUhjhUGYy5UB .lineWrapper line{stroke:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled circle,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:lightgray;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:#efefef;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-7 rect,#mermaid-svg-uRRSRUhjhUGYy5UB .section-7 path,#mermaid-svg-uRRSRUhjhUGYy5UB .section-7 circle,#mermaid-svg-uRRSRUhjhUGYy5UB .section-7 path{fill:hsl(90, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .section-7 text{fill:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .node-icon-7{font-size:40px;color:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-edge-7{stroke:hsl(90, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-depth-7{stroke-width:-7;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-7 line{stroke:hsl(270, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-uRRSRUhjhUGYy5UB .lineWrapper line{stroke:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled circle,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:lightgray;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:#efefef;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-8 rect,#mermaid-svg-uRRSRUhjhUGYy5UB .section-8 path,#mermaid-svg-uRRSRUhjhUGYy5UB .section-8 circle,#mermaid-svg-uRRSRUhjhUGYy5UB .section-8 path{fill:hsl(150, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .section-8 text{fill:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .node-icon-8{font-size:40px;color:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-edge-8{stroke:hsl(150, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-depth-8{stroke-width:-10;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-8 line{stroke:hsl(330, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-uRRSRUhjhUGYy5UB .lineWrapper line{stroke:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled circle,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:lightgray;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:#efefef;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-9 rect,#mermaid-svg-uRRSRUhjhUGYy5UB .section-9 path,#mermaid-svg-uRRSRUhjhUGYy5UB .section-9 circle,#mermaid-svg-uRRSRUhjhUGYy5UB .section-9 path{fill:hsl(180, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .section-9 text{fill:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .node-icon-9{font-size:40px;color:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-edge-9{stroke:hsl(180, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-depth-9{stroke-width:-13;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-9 line{stroke:hsl(0, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-uRRSRUhjhUGYy5UB .lineWrapper line{stroke:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled circle,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:lightgray;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:#efefef;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-10 rect,#mermaid-svg-uRRSRUhjhUGYy5UB .section-10 path,#mermaid-svg-uRRSRUhjhUGYy5UB .section-10 circle,#mermaid-svg-uRRSRUhjhUGYy5UB .section-10 path{fill:hsl(210, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .section-10 text{fill:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .node-icon-10{font-size:40px;color:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-edge-10{stroke:hsl(210, 100%, 76.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .edge-depth-10{stroke-width:-16;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-10 line{stroke:hsl(30, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-uRRSRUhjhUGYy5UB .lineWrapper line{stroke:black;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled circle,#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:lightgray;}#mermaid-svg-uRRSRUhjhUGYy5UB .disabled text{fill:#efefef;}#mermaid-svg-uRRSRUhjhUGYy5UB .section-root rect,#mermaid-svg-uRRSRUhjhUGYy5UB .section-root path,#mermaid-svg-uRRSRUhjhUGYy5UB .section-root circle{fill:hsl(240, 100%, 46.2745098039%);}#mermaid-svg-uRRSRUhjhUGYy5UB .section-root text{fill:#ffffff;}#mermaid-svg-uRRSRUhjhUGYy5UB .icon-container{height:100%;display:flex;justify-content:center;align-items:center;}#mermaid-svg-uRRSRUhjhUGYy5UB .edge{fill:none;}#mermaid-svg-uRRSRUhjhUGYy5UB .eventWrapper{filter:brightness(120%);}#mermaid-svg-uRRSRUhjhUGYy5UB :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

先秦时期

春秋

粽子雏形(角黍)出现

战国

屈原投汨罗江(前278年)

汉魏六朝

东汉

《说文解字》记载"粽"

南朝

《续齐谐记》屈原传说定型

西晋

《风土记》记载端午食粽

唐宋时期

唐代

粽子成为端午专属食品

宋代

馅料多样化，出现蜜粽、角粽

明清至今

明清

地域特色分化定型

2006

列入国家级非遗名录

2009

入选UNESCO人类非遗名录

端午节与粽子文化演进时间线

1.2 粽子的文化象征

粽子不仅是一种食物，更是承载多重文化象征的符号载体。从形态上看，粽子的三角锥形象征着"天圆地方"的宇宙观——粽叶包裹的糯米团被捆扎成有棱有角的形状，暗合古人"方正做人"的道德期许。从材料上看，粽叶（多为箬叶或苇叶）的清香、糯米的黏韧、馅料的丰富，共同构成了"和而不同"的味觉哲学——不同食材在粽叶的包裹中和谐共存，恰如中华文化的包容特质。

从仪式功能上看，粽子最初是祭祀用品——投江祭屈原、祭水神、祭祖先。随着时代演变，粽子从神圣的祭品逐渐世俗化为节庆食品，但其"馈赠"功能保留至今——端午送粽、邻里互赠，强化了社会关系的纽带。北京大学高丙中教授指出，端午节通过粽子等物质载体，实现了"中国人的认同文化"——无论地域南北、馅料甜咸，吃粽子这一行为本身就是文化认同的表达。

1.3 非遗保护与文化传承

2009年，“端午节"经联合国教科文组织批准列入《人类非物质文化遗产代表作名录》，成为中国首个入选世界非遗的节日。这一认定标志着端午节从"中国传统节日"升格为"人类共同文化财富”，也赋予了粽子文化新的保护责任。

非遗保护的核心不是将文化"博物馆化"——冻结在某个历史时刻，而是让文化在当代生活中保持活力。粽子文化的活态传承，需要既保留传统工艺的精髓，又适应现代生活的节奏。这正是本文开发"包粽子模拟器"的初衷——用Python代码模拟包粽子的步骤，让无法亲身体验传统工艺的年轻人，通过交互式游戏理解粽子制作的工艺逻辑，进而产生对传统文化的兴趣与认同。

2 粽子的种类谱系与地域文化

中国幅员辽阔，各地粽子在形态、馅料、口味上差异显著，形成了丰富的地域谱系。这种差异不仅是饮食习惯的体现，更是地理环境、物产资源、历史移民等多重因素共同塑造的文化景观。

2.1 南北甜咸之争：饮食文化的地理分野

中国粽子最显著的差异是"南咸北甜"的口味分野。北方以甜粽为主，典型代表是北京枣粽——以糯米包裹红枣、豆沙，蘸糖食用，口感清甜。南方则以咸粽为主，典型代表是嘉兴肉粽——以糯米包裹腌制猪肉，咸香可口。这一甜咸分野与中国整体饮食文化的"南甜北咸"格局看似矛盾，实则有其内在逻辑。

民俗学者指出，粽子馅料的甜咸分化与粽子的功能演变有关。北方粽子保留了较多"点心"属性——作为茶点或甜品，故以甜味为主；南方粽子则发展出"主食"属性——作为一餐的主食，需要咸味菜肴搭配，故以肉粽、蛋黄粽为主。这一功能差异又与南方的稻作文化和北方的旱作农业有关——南方糯米产量高，粽子可作主食；北方糯米相对稀缺，粽子更多作为节庆点心。

2.2 地域特色粽子图谱

2.3 少数民族粽子与海外传播

粽子文化不仅流传于汉族，也传播到各少数民族和海外华人社区。壮族有"灰粽"——用稻草灰浸染糯米，呈灰黑色，寓意驱邪；傣族有"竹筒粽"——用竹筒代替粽叶，蒸煮后竹香入米；瑶族有"艾叶粽"——加入艾草，兼具药用价值。

随着华人移民，粽子传播到东南亚、日韩等地。日本有"茅卷"（ちまき），用茅叶包裹糯米，形态与中国粽子相似；越南有"方粽"（Bánh chưng），方形，传说源于雄王时期；新加坡、马来西亚的娘惹粽，融合了南洋香料，形成独特的"娘惹风味"。这些海外变体既是中华文化的传播见证，也是文化本土化的生动案例。

#mermaid-svg-5Safdnj9S3KKOasZ{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-5Safdnj9S3KKOasZ .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-5Safdnj9S3KKOasZ .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-5Safdnj9S3KKOasZ .error-icon{fill:#552222;}#mermaid-svg-5Safdnj9S3KKOasZ .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-5Safdnj9S3KKOasZ .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-5Safdnj9S3KKOasZ .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-5Safdnj9S3KKOasZ .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-5Safdnj9S3KKOasZ .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-5Safdnj9S3KKOasZ .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-5Safdnj9S3KKOasZ .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-5Safdnj9S3KKOasZ .marker{fill:#333333;stroke:#333333;}#mermaid-svg-5Safdnj9S3KKOasZ .marker.cross{stroke:#333333;}#mermaid-svg-5Safdnj9S3KKOasZ svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-5Safdnj9S3KKOasZ p{margin:0;}#mermaid-svg-5Safdnj9S3KKOasZ .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-5Safdnj9S3KKOasZ .cluster-label text{fill:#333;}#mermaid-svg-5Safdnj9S3KKOasZ .cluster-label span{color:#333;}#mermaid-svg-5Safdnj9S3KKOasZ .cluster-label span p{background-color:transparent;}#mermaid-svg-5Safdnj9S3KKOasZ .label text,#mermaid-svg-5Safdnj9S3KKOasZ span{fill:#333;color:#333;}#mermaid-svg-5Safdnj9S3KKOasZ .node rect,#mermaid-svg-5Safdnj9S3KKOasZ .node circle,#mermaid-svg-5Safdnj9S3KKOasZ .node ellipse,#mermaid-svg-5Safdnj9S3KKOasZ .node polygon,#mermaid-svg-5Safdnj9S3KKOasZ .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-5Safdnj9S3KKOasZ .rough-node .label text,#mermaid-svg-5Safdnj9S3KKOasZ .node .label text,#mermaid-svg-5Safdnj9S3KKOasZ .image-shape .label,#mermaid-svg-5Safdnj9S3KKOasZ .icon-shape .label{text-anchor:middle;}#mermaid-svg-5Safdnj9S3KKOasZ .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-5Safdnj9S3KKOasZ .rough-node .label,#mermaid-svg-5Safdnj9S3KKOasZ .node .label,#mermaid-svg-5Safdnj9S3KKOasZ .image-shape .label,#mermaid-svg-5Safdnj9S3KKOasZ .icon-shape .label{text-align:center;}#mermaid-svg-5Safdnj9S3KKOasZ .node.clickable{cursor:pointer;}#mermaid-svg-5Safdnj9S3KKOasZ .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-5Safdnj9S3KKOasZ .arrowheadPath{fill:#333333;}#mermaid-svg-5Safdnj9S3KKOasZ .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-5Safdnj9S3KKOasZ .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-5Safdnj9S3KKOasZ .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-5Safdnj9S3KKOasZ .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-5Safdnj9S3KKOasZ .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-5Safdnj9S3KKOasZ .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-5Safdnj9S3KKOasZ .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-5Safdnj9S3KKOasZ .cluster text{fill:#333;}#mermaid-svg-5Safdnj9S3KKOasZ .cluster span{color:#333;}#mermaid-svg-5Safdnj9S3KKOasZ div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-5Safdnj9S3KKOasZ .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-5Safdnj9S3KKOasZ rect.text{fill:none;stroke-width:0;}#mermaid-svg-5Safdnj9S3KKOasZ .icon-shape,#mermaid-svg-5Safdnj9S3KKOasZ .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-5Safdnj9S3KKOasZ .icon-shape p,#mermaid-svg-5Safdnj9S3KKOasZ .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-5Safdnj9S3KKOasZ .icon-shape .label rect,#mermaid-svg-5Safdnj9S3KKOasZ .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-5Safdnj9S3KKOasZ .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-5Safdnj9S3KKOasZ .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-5Safdnj9S3KKOasZ :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

中国粽子文化圈

北方甜粽系

南方咸粽系

少数民族粽系

海外华人粽系

北京枣粽

黄米粽

苏州枣泥粽

嘉兴肉粽

广东裹蒸粽

闽南烧肉粽

四川辣粽

壮族灰粽

傣族竹筒粽

瑶族艾叶粽

日本茅卷

越南方粽

娘惹粽

3 粽子制作工艺的传统智慧

粽子的制作工艺凝聚了古人的饮食智慧，从选料到包扎，每一步都有其科学道理。理解这些工艺原理，是开发包粽子模拟器的知识基础。

3.1 选料：粽叶、糯米与馅料

粽叶的选择是粽子风味的基础。常用的粽叶有箬叶（竹叶的一种）、苇叶、荷叶等。箬叶清香淡雅，是南方粽子的主流用叶；苇叶略带草香，多用于北方；荷叶清香浓郁，但包裹难度较大。粽叶使用前需浸泡软化，这一步骤不仅是物理软化，更激活了叶片中的芳香物质——浸泡后的粽叶散发的清香，正是粽子独特风味的来源。

糯米的选用同样关键。优质糯米应粒形饱满、色泽乳白、无碎米。糯米在包制前需浸泡4-8小时，使其含水率达到约30%。浸泡的科学原理是让米粒充分吸水，蒸煮时淀粉均匀糊化，避免"夹生"。浸泡不足会导致米心硬芯；浸泡过度则米粒易碎，口感发糊。

馅料的准备因品种而异。肉粽的猪肉需用酱油、料酒、糖腌制12小时以上，使调味渗透；蛋黄需选用咸鸭蛋黄，蒸熟后油润起沙；红枣需去核浸泡，避免枣核伤牙；豆沙需自制或选购细豆沙，甜度适中。馅料的预处理直接影响粽子的最终风味。

3.2 包扎：折叠与缠绕的技艺

包粽子的核心技艺在于粽叶的折叠和粽绳的缠绕。以最常见的三角粽为例，包扎步骤如下：

第一步，取两片粽叶（光面朝内），重叠约1/3，左手握住粽叶根部，右手将粽叶卷成漏斗状，注意漏斗尖端要封闭，不能漏米。

第二步，先放入少量糯米（约漏斗容量的1/3），用筷子轻捣使米粒紧实。

第三步，放入馅料（肉块、蛋黄、红枣等），馅料居中。

第四步，再覆盖糯米至接近漏斗口，用手指压实，但不可过紧——留出约5%的空间供米粒膨胀。

第五步，将上方的粽叶向下折叠，覆盖漏斗口，顺势将多余的粽叶沿三角形的棱边折叠包裹，形成三角锥形。

第六步，用粽绳（或棉线）在粽子腰部缠绕数圈，打结固定。绳子的松紧度至关重要——过松煮时散开，过紧米粒无法膨胀。

#mermaid-svg-8rs8vHrFmgQVJ30O{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-8rs8vHrFmgQVJ30O .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-8rs8vHrFmgQVJ30O .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-8rs8vHrFmgQVJ30O .error-icon{fill:#552222;}#mermaid-svg-8rs8vHrFmgQVJ30O .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-8rs8vHrFmgQVJ30O .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-8rs8vHrFmgQVJ30O .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-8rs8vHrFmgQVJ30O .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-8rs8vHrFmgQVJ30O .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-8rs8vHrFmgQVJ30O .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-8rs8vHrFmgQVJ30O .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-8rs8vHrFmgQVJ30O .marker{fill:#333333;stroke:#333333;}#mermaid-svg-8rs8vHrFmgQVJ30O .marker.cross{stroke:#333333;}#mermaid-svg-8rs8vHrFmgQVJ30O svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-8rs8vHrFmgQVJ30O p{margin:0;}#mermaid-svg-8rs8vHrFmgQVJ30O .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-8rs8vHrFmgQVJ30O .cluster-label text{fill:#333;}#mermaid-svg-8rs8vHrFmgQVJ30O .cluster-label span{color:#333;}#mermaid-svg-8rs8vHrFmgQVJ30O .cluster-label span p{background-color:transparent;}#mermaid-svg-8rs8vHrFmgQVJ30O .label text,#mermaid-svg-8rs8vHrFmgQVJ30O span{fill:#333;color:#333;}#mermaid-svg-8rs8vHrFmgQVJ30O .node rect,#mermaid-svg-8rs8vHrFmgQVJ30O .node circle,#mermaid-svg-8rs8vHrFmgQVJ30O .node ellipse,#mermaid-svg-8rs8vHrFmgQVJ30O .node polygon,#mermaid-svg-8rs8vHrFmgQVJ30O .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-8rs8vHrFmgQVJ30O .rough-node .label text,#mermaid-svg-8rs8vHrFmgQVJ30O .node .label text,#mermaid-svg-8rs8vHrFmgQVJ30O .image-shape .label,#mermaid-svg-8rs8vHrFmgQVJ30O .icon-shape .label{text-anchor:middle;}#mermaid-svg-8rs8vHrFmgQVJ30O .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-8rs8vHrFmgQVJ30O .rough-node .label,#mermaid-svg-8rs8vHrFmgQVJ30O .node .label,#mermaid-svg-8rs8vHrFmgQVJ30O .image-shape .label,#mermaid-svg-8rs8vHrFmgQVJ30O .icon-shape .label{text-align:center;}#mermaid-svg-8rs8vHrFmgQVJ30O .node.clickable{cursor:pointer;}#mermaid-svg-8rs8vHrFmgQVJ30O .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-8rs8vHrFmgQVJ30O .arrowheadPath{fill:#333333;}#mermaid-svg-8rs8vHrFmgQVJ30O .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-8rs8vHrFmgQVJ30O .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-8rs8vHrFmgQVJ30O .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-8rs8vHrFmgQVJ30O .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-8rs8vHrFmgQVJ30O .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-8rs8vHrFmgQVJ30O .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-8rs8vHrFmgQVJ30O .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-8rs8vHrFmgQVJ30O .cluster text{fill:#333;}#mermaid-svg-8rs8vHrFmgQVJ30O .cluster span{color:#333;}#mermaid-svg-8rs8vHrFmgQVJ30O div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-8rs8vHrFmgQVJ30O .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-8rs8vHrFmgQVJ30O rect.text{fill:none;stroke-width:0;}#mermaid-svg-8rs8vHrFmgQVJ30O .icon-shape,#mermaid-svg-8rs8vHrFmgQVJ30O .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-8rs8vHrFmgQVJ30O .icon-shape p,#mermaid-svg-8rs8vHrFmgQVJ30O .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-8rs8vHrFmgQVJ30O .icon-shape .label rect,#mermaid-svg-8rs8vHrFmgQVJ30O .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-8rs8vHrFmgQVJ30O .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-8rs8vHrFmgQVJ30O .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-8rs8vHrFmgQVJ30O :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

选叶浸泡

折叠成漏斗

铺底米

放入馅料

覆盖糯米

折叠封口

缠绕粽绳

打结固定

入锅煮制

成品出锅

3.3 煮制：火候与时间的艺术

粽子的煮制是最后的关键环节。传统做法是将粽子放入大锅，加水没过粽子，大火煮沸后转小火慢煮2-4小时。煮制时间因粽子大小和馅料而异——小粽2小时即可，大粽（如广东裹蒸粽）需4-6小时。

煮制的科学原理是淀粉的充分糊化和馅料的入味。糯米中的支链淀粉在约65°C开始糊化，但完全糊化需要持续加热。长时间小火慢煮确保米心完全熟透，同时让粽叶的清香和馅料的调味充分渗透到每一粒米中。煮好后不宜立即出锅，应在锅中焖1-2小时，使风味进一步融合——这一"焖"的步骤，往往是老手与新手的区别所在。

4 Python模拟器的设计理念与技术架构

将传统粽子制作工艺转化为Python模拟器，需要在文化保真与技术可行性之间取得平衡。本节阐述模拟器的设计理念、技术选型和架构设计。

4.1 设计理念：游戏化传承

模拟器的设计理念是"游戏化传承"——通过游戏化的交互体验，让用户在模拟包粽子的过程中理解传统工艺的步骤和要点。设计上遵循三个原则：

第一，工艺还原性——模拟器的流程严格对应真实包粽子的步骤（选料→折叶→填米→加馅→系绳→煮制），让用户建立完整的工艺认知。

第二，交互趣味性——通过进度条、评分系统、视觉反馈等游戏元素，提升用户体验的趣味性，避免枯燥的步骤演示。

第三，文化教育性——在模拟过程中融入粽子文化知识（地域特色、历史典故），实现"寓教于乐"。

4.2 技术选型：Pygame框架

模拟器基于Pygame框架开发。Pygame是Python的2D游戏开发库，具有以下优势：

• 轻量级：无需复杂依赖，pip安装即可使用
• 跨平台：支持Windows、Linux、macOS
• 中文支持：通过指定中文字体文件，可完美显示中文
• 即时渲染：适合交互式应用的实时渲染需求

中文字体兼容性是Windows系统开发的关键问题。Pygame默认字体不支持中文，需要显式指定中文字体。在Windows系统中，常用中文字体包括"微软雅黑"（msyh.ttc）、“宋体”（simsun.ttc）等。模拟器采用字体查找策略：优先使用系统微软雅黑，若不存在则回退到SimHei，最后回退到Pygame默认字体，确保跨环境兼容。

4.3 架构设计：状态机模式

模拟器采用有限状态机（Finite State Machine, FSM）架构管理游戏流程。FSM将游戏划分为8个离散状态：主菜单、选择馅料、折叠粽叶、添加糯米、添加馅料、缠绕粽绳、煮制、结果展示。每个状态有独立的渲染逻辑和事件处理逻辑，状态之间通过用户输入触发转移。

FSM的数学模型可以表示为五元组

M

=

(

Q

,

Σ

,

δ

,

q

0

,

F

)

M = (Q, \\Sigma, \\delta, q_0, F)

M=(Q,Σ,δ,q0​,F)，其中：

• $Q$
• $\Sigma$
• $\delta :Q\times \Sigma \to Q$
• $q_0=q_{\text{menu}}$
• $F=\{q_{\text{result}}\}$

5 核心代码实现与原理解析

本节深入解析模拟器的核心代码实现，包括初始化、状态管理、渲染逻辑和交互处理。

5.1 初始化与字体加载

模拟器的初始化包括Pygame引擎初始化、窗口创建、字体加载和资源准备。字体加载是中文显示的关键：

def _init_fonts(self):
"""初始化字体，兼容Windows中文显示"""
font_candidates = [
"microsoftyahei", # Windows 微软雅黑
"msyh", # Windows 微软雅黑简写
"simhei", # Windows 黑体
"simsun", # Windows 宋体
"notosanscjksc", # Linux Noto CJK
"wenquanyimicrohei", # Linux 文泉驿
"arial", # 通用回退
]
self.font_title = pygame.font.SysFont(font_candidates, 36, bold=True)
self.font_large = pygame.font.SysFont(font_candidates, 28)
self.font_medium = pygame.font.SysFont(font_candidates, 22)
self.font_small = pygame.font.SysFont(font_candidates, 18)

pygame.font.SysFont接受字体名称列表，会按顺序查找第一个可用的字体。这一策略确保了在Windows、Linux、macOS上都能正确显示中文。

5.2 游戏主循环

Pygame的核心是事件驱动的游戏主循环。主循环以60FPS的频率运行，每次循环处理三类任务：事件处理、状态更新、画面渲染。

def run(self):
"""主游戏循环"""
clock = pygame.time.Clock()
self.running = True

while self.running:
dt = clock.tick(FPS) / 1000.0 # 帧间隔(秒)

# 1. 事件处理
self._handle_events()

# 2. 状态更新
self._update(dt)

# 3. 画面渲染
self._render()

pygame.display.flip()

帧率控制通过clock.tick(FPS)实现，该方法返回距上一帧的毫秒数，并限制帧率不超过60FPS。dt（delta time）参数用于确保动画速度与帧率无关——无论实际帧率如何，物体移动速度保持一致。

5.3 粽子绘制算法

粽子的视觉呈现是模拟器的核心。三角粽的绘制采用多边形组合方式：

def _draw_zongzi(self, cx, cy, scale=1.0, cooked=False):
"""绘制三角粽"""
s = scale
# 粽叶三角形(三个面)
leaf_color = COLOR_LEAF_DARK if cooked else COLOR_LEAF

# 正面三角形
points_front = [
(cx, cy – 60*s),
(cx – 50*s, cy + 40*s),
(cx + 50*s, cy + 40*s)
]
pygame.draw.polygon(self.screen, leaf_color, points_front)

# 糯米填充(顶部白色区域)
rice_color = COLOR_RICE_COOKED if cooked else COLOR_RICE
points_rice = [
(cx, cy – 45*s),
(cx – 35*s, cy + 25*s),
(cx + 35*s, cy + 25*s)
]
pygame.draw.polygon(self.screen, rice_color, points_rice)

# 馅料(中心点)
if self.filling_type:
filling = FILLINGS[self.filling_type]
pygame.draw.circle(self.screen, filling["color"],
(int(cx), int(cy)), int(12*s))

# 粽绳横线
for i in range(self.string_wraps):
y = cy – 20*s + i * 15*s
pygame.draw.line(self.screen, COLOR_STRING,
(cx – 55*s, y), (cx + 55*s, y), 3)

绘制算法的要点是分层渲染：先绘制粽叶背景（深绿三角形），再绘制糯米填充（浅色内三角），然后绘制馅料（中心圆形），最后绘制粽绳（横线）。这种分层顺序确保了视觉上的遮挡关系正确。

5.4 评分系统

评分系统根据用户在各个步骤的操作质量计算最终得分：

def _calculate_result(self):
"""计算制作结果"""
score = 100
# 糯米量评分(理想70%-95%)
if self.rice_amount < 0.7:
score -= 20
elif self.rice_amount > 0.95:
score -= 10
# 粽绳圈数评分(至少3圈)
if self.string_wraps < 2:
score -= 30
elif self.string_wraps < 3:
score -= 10
# 折叠完整度(目标90°)
if self.leaf_fold_angle < 50:
score -= 15

self.result_score = max(0, score)
# 评级
if score >= 90:
self.result_quality = "优秀 – 完美粽子!"
elif score >= 75:
self.result_quality = "良好 – 美味可口"
elif score >= 60:
self.result_quality = "合格 – 还能入口"
else:
self.result_quality = "待改进 – 继续努力"

评分逻辑对应真实包粽子的关键要点：糯米量过少则粽子干瘪，过多则煮时爆裂；粽绳圈数不足则煮时散开；折叠角度不够则漏米。这些评分规则将传统工艺经验编码为可计算的指标。

评分系统的设计借鉴了游戏设计中的"心流理论"（Flow Theory）。心理学家米哈里·契克森米哈伊提出，当任务难度与用户技能匹配时，用户会进入"心流"状态——高度专注且享受的体验。模拟器的评分阈值经过调校：60分以下的"待改进"提供改进动力，75-89分的"良好"给予正向反馈，90分以上的"优秀"设定挑战目标。这种梯度设计确保不同水平的用户都能获得适当的挑战和满足感。

5.5 交互反馈机制

良好的交互反馈是游戏体验的关键。模拟器在多个层面提供反馈：

视觉反馈——每个操作都有对应的视觉变化。添加糯米时，粽子内部的白色区域逐渐扩大；缠绕粽绳时，粽子上的横线逐条增加；煮制时，粽子颜色从生绿变为熟绿。这些视觉变化让用户直观感知操作效果。

进度反馈——每个步骤都有进度条显示完成度。折叠粽叶的角度进度、糯米量的填充进度、煮制的时间进度，都通过进度条可视化，帮助用户掌握节奏。

文字反馈——在关键操作后给出文字提示。如糯米量达到70%时提示"糯米量已足够"，粽绳缠满3圈时提示"粽绳已牢固"。这些提示既指导操作，又传递工艺知识。

6 模拟器的文化教育功能

包粽子模拟器不仅是一个游戏，更是一个文化教育载体。本节探讨模拟器如何实现文化传承功能，以及数字技术在传统文化传播中的独特价值。

6.1 体验式学习理论

模拟器的教育功能基于"体验式学习"（Experiential Learning）理论。教育学家大卫·库伯提出的体验式学习循环包括四个阶段：具体体验、反思观察、抽象概念化和主动实验。模拟器通过交互操作提供"具体体验"，通过文字提示引导"反思观察"，通过工艺标准传递"抽象概念化"，通过反复尝试支持"主动实验"。

与传统文字或视频教学相比，模拟器的优势在于"做中学"（Learning by Doing）。用户不是被动接受粽子制作知识，而是通过亲手操作（虽然是虚拟的）理解每个步骤的要领。这种主动参与的学习方式，知识留存率显著高于被动接受。教育心理学研究表明，通过实践操作获得的知识，其留存率可达75%，而通过听讲仅能留存5%。

6.2 文化情境的构建

模拟器通过多个维度构建文化情境，让用户在操作中感受文化氛围。视觉上，米黄色背景模拟传统厨房环境，粽叶绿和糯米白还原粽子本色，色彩搭配传递温暖质朴的乡土气息。内容上，馅料选择附带地域信息——选择"嘉兴肉粽"时显示"江南"标签，选择"北京枣粽"时显示"北方"标签，让用户在操作中了解地域文化差异。

文字提示也融入文化元素。如折叠粽叶时提示"将粽叶卷成漏斗状，这是包粽子的第一步"，不仅指导操作，还传递工艺术语；煮制完成时显示"粽香四溢，端午安康！"，将祝福语融入交互。这些细节共同构建了沉浸式的文化体验。

6.3 跨代际文化传递

模拟器的一个重要价值是促进跨代际文化传递。在数字化时代，年轻一代与传统文化的接触日益减少——许多年轻人从未亲手包过粽子，甚至不了解粽子的制作过程。模拟器以游戏化的形式吸引年轻用户，让他们在娱乐中接触传统文化。

更深层的是，模拟器可以成为代际交流的媒介。年轻人通过模拟器了解包粽子的基本流程后，可能会在端午节时与长辈一起实际包粽子，将虚拟体验转化为现实传承。模拟器不是替代真实体验，而是激发兴趣、降低门槛，为真实的文化实践创造条件。

6.4 数字文化传承的范式

包粽子模拟器代表了数字文化传承的一种新范式——“交互式文化体验”。传统的文化传承主要依靠口传心授和仪式参与，受限于时间和空间。数字技术打破了这些限制，让任何人、在任何时间、任何地点都能体验传统文化。

这一范式的理论基础是"数字人文"（Digital Humanities）——用人文学科的方法研究数字技术，用数字技术赋能人文学科。模拟器将民俗学的田野调查成果（粽子制作工艺）转化为可交互的数字内容，实现了从"学术研究"到"公众体验"的转化。这种转化不仅扩大了文化传承的覆盖面，也为学术研究提供了新的传播渠道。

#mermaid-svg-ezdyF9I9IWRS87Jj{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-ezdyF9I9IWRS87Jj .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-ezdyF9I9IWRS87Jj .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-ezdyF9I9IWRS87Jj .error-icon{fill:#552222;}#mermaid-svg-ezdyF9I9IWRS87Jj .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-ezdyF9I9IWRS87Jj .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-ezdyF9I9IWRS87Jj .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-ezdyF9I9IWRS87Jj .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-ezdyF9I9IWRS87Jj .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-ezdyF9I9IWRS87Jj .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-ezdyF9I9IWRS87Jj .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-ezdyF9I9IWRS87Jj .marker{fill:#333333;stroke:#333333;}#mermaid-svg-ezdyF9I9IWRS87Jj .marker.cross{stroke:#333333;}#mermaid-svg-ezdyF9I9IWRS87Jj svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-ezdyF9I9IWRS87Jj p{margin:0;}#mermaid-svg-ezdyF9I9IWRS87Jj .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-ezdyF9I9IWRS87Jj .cluster-label text{fill:#333;}#mermaid-svg-ezdyF9I9IWRS87Jj .cluster-label span{color:#333;}#mermaid-svg-ezdyF9I9IWRS87Jj .cluster-label span p{background-color:transparent;}#mermaid-svg-ezdyF9I9IWRS87Jj .label text,#mermaid-svg-ezdyF9I9IWRS87Jj span{fill:#333;color:#333;}#mermaid-svg-ezdyF9I9IWRS87Jj .node rect,#mermaid-svg-ezdyF9I9IWRS87Jj .node circle,#mermaid-svg-ezdyF9I9IWRS87Jj .node ellipse,#mermaid-svg-ezdyF9I9IWRS87Jj .node polygon,#mermaid-svg-ezdyF9I9IWRS87Jj .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-ezdyF9I9IWRS87Jj .rough-node .label text,#mermaid-svg-ezdyF9I9IWRS87Jj .node .label text,#mermaid-svg-ezdyF9I9IWRS87Jj .image-shape .label,#mermaid-svg-ezdyF9I9IWRS87Jj .icon-shape .label{text-anchor:middle;}#mermaid-svg-ezdyF9I9IWRS87Jj .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-ezdyF9I9IWRS87Jj .rough-node .label,#mermaid-svg-ezdyF9I9IWRS87Jj .node .label,#mermaid-svg-ezdyF9I9IWRS87Jj .image-shape .label,#mermaid-svg-ezdyF9I9IWRS87Jj .icon-shape .label{text-align:center;}#mermaid-svg-ezdyF9I9IWRS87Jj .node.clickable{cursor:pointer;}#mermaid-svg-ezdyF9I9IWRS87Jj .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-ezdyF9I9IWRS87Jj .arrowheadPath{fill:#333333;}#mermaid-svg-ezdyF9I9IWRS87Jj .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-ezdyF9I9IWRS87Jj .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-ezdyF9I9IWRS87Jj .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-ezdyF9I9IWRS87Jj .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-ezdyF9I9IWRS87Jj .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-ezdyF9I9IWRS87Jj .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-ezdyF9I9IWRS87Jj .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-ezdyF9I9IWRS87Jj .cluster text{fill:#333;}#mermaid-svg-ezdyF9I9IWRS87Jj .cluster span{color:#333;}#mermaid-svg-ezdyF9I9IWRS87Jj div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-ezdyF9I9IWRS87Jj .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-ezdyF9I9IWRS87Jj rect.text{fill:none;stroke-width:0;}#mermaid-svg-ezdyF9I9IWRS87Jj .icon-shape,#mermaid-svg-ezdyF9I9IWRS87Jj .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-ezdyF9I9IWRS87Jj .icon-shape p,#mermaid-svg-ezdyF9I9IWRS87Jj .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-ezdyF9I9IWRS87Jj .icon-shape .label rect,#mermaid-svg-ezdyF9I9IWRS87Jj .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-ezdyF9I9IWRS87Jj .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-ezdyF9I9IWRS87Jj .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-ezdyF9I9IWRS87Jj :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

民俗学研究

工艺知识提取

数字化建模

交互式模拟器

用户体验

文化认知

现实实践

文化传承

7 运行测试与部署

7.1 环境配置

模拟器的运行环境要求如下：Python 3.8及以上版本，pygame 2.0及以上版本，操作系统支持Windows、macOS和Linux。在Windows系统上，中文字符的显示需要特别注意字体配置——模拟器使用SysFont自动获取系统默认中文字体（如微软雅黑、宋体），确保中文正常显示。

安装依赖只需一条命令：pip install pygame。pygame是Python最流行的2D游戏开发库，由Pete Shinners于2000年创建，基于SDL（Simple DirectMedia Layer）库开发。pygame提供了图形绘制、事件处理、音频播放等完整功能，适合开发2D游戏和交互式应用。

7.2 测试验证

模拟器在开发过程中经过了多轮测试验证。功能测试确保每个状态转换正确——从主菜单到选择馅料，从折叠粽叶到添加糯米，每个步骤的流程逻辑无误。交互测试验证鼠标点击、键盘按键的响应正确性。渲染测试检查中文字体在不同操作系统上的显示效果。

在沙箱环境中，使用SDL_VIDEODRIVER=dummy参数进行无头测试（Headless Test），验证程序逻辑不依赖实际显示设备也能正常运行。这种测试方式常用于CI/CD流水线，确保代码质量。测试结果显示，模拟器在无头模式下能正常初始化、处理事件、渲染帧，仅在实际显示时需要图形环境。

7.3 跨平台兼容性

模拟器的设计考虑了跨平台兼容性。字体方面，使用pygame.font.SysFont(None, size)获取系统默认字体，在Windows上自动使用微软雅黑，在macOS上使用PingFang SC，在Linux上使用Noto Sans CJK，确保中文显示正常。路径方面，使用os.path.join处理文件路径，避免不同操作系统的路径分隔符差异。编码方面，文件头部声明# — coding: utf-8 –，确保源代码中的中文字符正确解析。

6.1 工艺知识的显性化

传统手工艺的传承依赖"口传心授"，师傅的经验往往难以言传。模拟器通过将包粽子过程分解为离散步骤，并为每一步设置量化指标（如糯米量百分比、折叠角度、绳圈数），将隐性知识显性化。用户在模拟过程中，不仅"做"了粽子，更"理解"了每一步的道理——为什么糯米要留膨胀空间，为什么粽绳要缠三圈以上。

6.2 地域文化的展示

模拟器在选择馅料环节展示四种代表性粽子：红枣粽（北方）、鲜肉粽（江南）、蛋黄粽（广东）、豆沙粽（苏州）。每种馅料都标注地域来源和文化简介，用户在选择时潜移默化地了解地域饮食文化差异。这种"选择即学习"的设计，比单纯的知识灌输更有效。

6.3 节日氛围的营造

模拟器的视觉设计融入端午节元素：粽叶绿的配色方案、粽叶纹理的背景、端午安康的祝福语。这些元素共同营造了端午节的节日氛围，让用户在使用过程中感受到节日的文化温度。特别是结果页面的"端午安康"祝福，呼应了端午节的传统问候语，强化了文化认同。

7 技术挑战与解决方案

开发过程中遇到了若干技术挑战，本节总结主要挑战及解决方案。

7.1 中文字体跨平台兼容

挑战：Pygame默认字体不支持中文，不同操作系统可用的中文字体不同。Windows有微软雅黑、黑体；Linux有Noto CJK、文泉驿；macOS有苹方、华文黑体。

解决方案：采用字体名称列表策略，pygame.font.SysFont接受列表参数，按顺序查找第一个可用字体。代码中预设了覆盖三大平台的字体列表，确保任何环境下都能显示中文。

7.2 无显示环境下的测试

挑战：开发环境（Linux服务器）通常没有图形界面，无法直接运行Pygame窗口。

解决方案：使用SDL的dummy视频驱动，SDL_VIDEODRIVER=dummy python main.py，可以在无显示环境下运行Pygame进行功能测试。这一技巧在CI/CD流水线中测试Pygame应用非常有用。

7.3 动画流畅度与性能

挑战：粽子绘制涉及多边形、圆形、线条等多种图元，若每帧重新计算坐标可能影响性能。

解决方案：采用dt（帧间隔）参数化动画速度，确保动画流畅度与帧率无关。同时，对于静态元素（如背景、按钮），只在状态变化时重绘，减少不必要的渲染开销。

8 未来展望：数字技术赋能文化传承

包粽子模拟器是数字技术赋能文化传承的一次实践。展望未来，这一方向还有广阔的发展空间。

8.1 增强现实（AR）包粽子

未来的模拟器可以结合AR技术，通过手机摄像头将虚拟粽子叠加到现实桌面，用户用手势"包"虚拟粽子。这种沉浸式体验将大大增强文化传承的感染力。Apple的ARKit和Google的ARCore已经提供了成熟的手势识别API，技术可行性已经具备。

8.2 多人协作包粽子

传统包粽子往往是家庭或社区的集体活动——一家人围坐包粽，边包边聊，增进感情。模拟器可以扩展为多人在线协作模式，不同用户分工完成不同步骤，再现集体劳作的文化场景。这一功能需要引入网络通信模块，但能更好地还原粽子的社交属性。

8.3 文化大数据的融入

模拟器可以接入粽子文化大数据——各地粽子种类、历史典故、制作视频等，根据用户的选择动态推送相关知识。例如，用户选择"嘉兴肉粽"时，模拟器自动展示嘉兴粽子的历史渊源和制作要点。这一功能将模拟器从"游戏"升级为"文化百科"。

8.4 人工智能辅助

引入AI技术，让模拟器具备"教学"能力。AI可以根据用户的操作实时给出建议——“糯米再加一点”、“粽绳缠得不够紧”。更进一步的，AI可以根据用户的口味偏好推荐适合的粽子种类，实现个性化文化体验。

#mermaid-svg-owXeqFLSEdBFmI3h{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-owXeqFLSEdBFmI3h .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-owXeqFLSEdBFmI3h .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-owXeqFLSEdBFmI3h .error-icon{fill:#552222;}#mermaid-svg-owXeqFLSEdBFmI3h .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-owXeqFLSEdBFmI3h .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-owXeqFLSEdBFmI3h .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-owXeqFLSEdBFmI3h .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-owXeqFLSEdBFmI3h .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-owXeqFLSEdBFmI3h .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-owXeqFLSEdBFmI3h .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-owXeqFLSEdBFmI3h .marker{fill:#333333;stroke:#333333;}#mermaid-svg-owXeqFLSEdBFmI3h .marker.cross{stroke:#333333;}#mermaid-svg-owXeqFLSEdBFmI3h svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-owXeqFLSEdBFmI3h p{margin:0;}#mermaid-svg-owXeqFLSEdBFmI3h .edge{stroke-width:3;}#mermaid-svg-owXeqFLSEdBFmI3h .section–1 rect,#mermaid-svg-owXeqFLSEdBFmI3h .section–1 path,#mermaid-svg-owXeqFLSEdBFmI3h .section–1 circle,#mermaid-svg-owXeqFLSEdBFmI3h .section–1 polygon,#mermaid-svg-owXeqFLSEdBFmI3h .section–1 path{fill:hsl(240, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .section–1 text{fill:#ffffff;}#mermaid-svg-owXeqFLSEdBFmI3h .node-icon–1{font-size:40px;color:#ffffff;}#mermaid-svg-owXeqFLSEdBFmI3h .section-edge–1{stroke:hsl(240, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .edge-depth–1{stroke-width:17;}#mermaid-svg-owXeqFLSEdBFmI3h .section–1 line{stroke:hsl(60, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled,#mermaid-svg-owXeqFLSEdBFmI3h .disabled circle,#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:lightgray;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:#efefef;}#mermaid-svg-owXeqFLSEdBFmI3h .section-0 rect,#mermaid-svg-owXeqFLSEdBFmI3h .section-0 path,#mermaid-svg-owXeqFLSEdBFmI3h .section-0 circle,#mermaid-svg-owXeqFLSEdBFmI3h .section-0 polygon,#mermaid-svg-owXeqFLSEdBFmI3h .section-0 path{fill:hsl(60, 100%, 73.5294117647%);}#mermaid-svg-owXeqFLSEdBFmI3h .section-0 text{fill:black;}#mermaid-svg-owXeqFLSEdBFmI3h .node-icon-0{font-size:40px;color:black;}#mermaid-svg-owXeqFLSEdBFmI3h .section-edge-0{stroke:hsl(60, 100%, 73.5294117647%);}#mermaid-svg-owXeqFLSEdBFmI3h .edge-depth-0{stroke-width:14;}#mermaid-svg-owXeqFLSEdBFmI3h .section-0 line{stroke:hsl(240, 100%, 83.5294117647%);stroke-width:3;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled,#mermaid-svg-owXeqFLSEdBFmI3h .disabled circle,#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:lightgray;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:#efefef;}#mermaid-svg-owXeqFLSEdBFmI3h .section-1 rect,#mermaid-svg-owXeqFLSEdBFmI3h .section-1 path,#mermaid-svg-owXeqFLSEdBFmI3h .section-1 circle,#mermaid-svg-owXeqFLSEdBFmI3h .section-1 polygon,#mermaid-svg-owXeqFLSEdBFmI3h .section-1 path{fill:hsl(80, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .section-1 text{fill:black;}#mermaid-svg-owXeqFLSEdBFmI3h .node-icon-1{font-size:40px;color:black;}#mermaid-svg-owXeqFLSEdBFmI3h .section-edge-1{stroke:hsl(80, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .edge-depth-1{stroke-width:11;}#mermaid-svg-owXeqFLSEdBFmI3h .section-1 line{stroke:hsl(260, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled,#mermaid-svg-owXeqFLSEdBFmI3h .disabled circle,#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:lightgray;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:#efefef;}#mermaid-svg-owXeqFLSEdBFmI3h .section-2 rect,#mermaid-svg-owXeqFLSEdBFmI3h .section-2 path,#mermaid-svg-owXeqFLSEdBFmI3h .section-2 circle,#mermaid-svg-owXeqFLSEdBFmI3h .section-2 polygon,#mermaid-svg-owXeqFLSEdBFmI3h .section-2 path{fill:hsl(270, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .section-2 text{fill:#ffffff;}#mermaid-svg-owXeqFLSEdBFmI3h .node-icon-2{font-size:40px;color:#ffffff;}#mermaid-svg-owXeqFLSEdBFmI3h .section-edge-2{stroke:hsl(270, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .edge-depth-2{stroke-width:8;}#mermaid-svg-owXeqFLSEdBFmI3h .section-2 line{stroke:hsl(90, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled,#mermaid-svg-owXeqFLSEdBFmI3h .disabled circle,#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:lightgray;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:#efefef;}#mermaid-svg-owXeqFLSEdBFmI3h .section-3 rect,#mermaid-svg-owXeqFLSEdBFmI3h .section-3 path,#mermaid-svg-owXeqFLSEdBFmI3h .section-3 circle,#mermaid-svg-owXeqFLSEdBFmI3h .section-3 polygon,#mermaid-svg-owXeqFLSEdBFmI3h .section-3 path{fill:hsl(300, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .section-3 text{fill:black;}#mermaid-svg-owXeqFLSEdBFmI3h .node-icon-3{font-size:40px;color:black;}#mermaid-svg-owXeqFLSEdBFmI3h .section-edge-3{stroke:hsl(300, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .edge-depth-3{stroke-width:5;}#mermaid-svg-owXeqFLSEdBFmI3h .section-3 line{stroke:hsl(120, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled,#mermaid-svg-owXeqFLSEdBFmI3h .disabled circle,#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:lightgray;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:#efefef;}#mermaid-svg-owXeqFLSEdBFmI3h .section-4 rect,#mermaid-svg-owXeqFLSEdBFmI3h .section-4 path,#mermaid-svg-owXeqFLSEdBFmI3h .section-4 circle,#mermaid-svg-owXeqFLSEdBFmI3h .section-4 polygon,#mermaid-svg-owXeqFLSEdBFmI3h .section-4 path{fill:hsl(330, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .section-4 text{fill:black;}#mermaid-svg-owXeqFLSEdBFmI3h .node-icon-4{font-size:40px;color:black;}#mermaid-svg-owXeqFLSEdBFmI3h .section-edge-4{stroke:hsl(330, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .edge-depth-4{stroke-width:2;}#mermaid-svg-owXeqFLSEdBFmI3h .section-4 line{stroke:hsl(150, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled,#mermaid-svg-owXeqFLSEdBFmI3h .disabled circle,#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:lightgray;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:#efefef;}#mermaid-svg-owXeqFLSEdBFmI3h .section-5 rect,#mermaid-svg-owXeqFLSEdBFmI3h .section-5 path,#mermaid-svg-owXeqFLSEdBFmI3h .section-5 circle,#mermaid-svg-owXeqFLSEdBFmI3h .section-5 polygon,#mermaid-svg-owXeqFLSEdBFmI3h .section-5 path{fill:hsl(0, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .section-5 text{fill:black;}#mermaid-svg-owXeqFLSEdBFmI3h .node-icon-5{font-size:40px;color:black;}#mermaid-svg-owXeqFLSEdBFmI3h .section-edge-5{stroke:hsl(0, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .edge-depth-5{stroke-width:-1;}#mermaid-svg-owXeqFLSEdBFmI3h .section-5 line{stroke:hsl(180, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled,#mermaid-svg-owXeqFLSEdBFmI3h .disabled circle,#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:lightgray;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:#efefef;}#mermaid-svg-owXeqFLSEdBFmI3h .section-6 rect,#mermaid-svg-owXeqFLSEdBFmI3h .section-6 path,#mermaid-svg-owXeqFLSEdBFmI3h .section-6 circle,#mermaid-svg-owXeqFLSEdBFmI3h .section-6 polygon,#mermaid-svg-owXeqFLSEdBFmI3h .section-6 path{fill:hsl(30, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .section-6 text{fill:black;}#mermaid-svg-owXeqFLSEdBFmI3h .node-icon-6{font-size:40px;color:black;}#mermaid-svg-owXeqFLSEdBFmI3h .section-edge-6{stroke:hsl(30, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .edge-depth-6{stroke-width:-4;}#mermaid-svg-owXeqFLSEdBFmI3h .section-6 line{stroke:hsl(210, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled,#mermaid-svg-owXeqFLSEdBFmI3h .disabled circle,#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:lightgray;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:#efefef;}#mermaid-svg-owXeqFLSEdBFmI3h .section-7 rect,#mermaid-svg-owXeqFLSEdBFmI3h .section-7 path,#mermaid-svg-owXeqFLSEdBFmI3h .section-7 circle,#mermaid-svg-owXeqFLSEdBFmI3h .section-7 polygon,#mermaid-svg-owXeqFLSEdBFmI3h .section-7 path{fill:hsl(90, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .section-7 text{fill:black;}#mermaid-svg-owXeqFLSEdBFmI3h .node-icon-7{font-size:40px;color:black;}#mermaid-svg-owXeqFLSEdBFmI3h .section-edge-7{stroke:hsl(90, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .edge-depth-7{stroke-width:-7;}#mermaid-svg-owXeqFLSEdBFmI3h .section-7 line{stroke:hsl(270, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled,#mermaid-svg-owXeqFLSEdBFmI3h .disabled circle,#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:lightgray;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:#efefef;}#mermaid-svg-owXeqFLSEdBFmI3h .section-8 rect,#mermaid-svg-owXeqFLSEdBFmI3h .section-8 path,#mermaid-svg-owXeqFLSEdBFmI3h .section-8 circle,#mermaid-svg-owXeqFLSEdBFmI3h .section-8 polygon,#mermaid-svg-owXeqFLSEdBFmI3h .section-8 path{fill:hsl(150, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .section-8 text{fill:black;}#mermaid-svg-owXeqFLSEdBFmI3h .node-icon-8{font-size:40px;color:black;}#mermaid-svg-owXeqFLSEdBFmI3h .section-edge-8{stroke:hsl(150, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .edge-depth-8{stroke-width:-10;}#mermaid-svg-owXeqFLSEdBFmI3h .section-8 line{stroke:hsl(330, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled,#mermaid-svg-owXeqFLSEdBFmI3h .disabled circle,#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:lightgray;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:#efefef;}#mermaid-svg-owXeqFLSEdBFmI3h .section-9 rect,#mermaid-svg-owXeqFLSEdBFmI3h .section-9 path,#mermaid-svg-owXeqFLSEdBFmI3h .section-9 circle,#mermaid-svg-owXeqFLSEdBFmI3h .section-9 polygon,#mermaid-svg-owXeqFLSEdBFmI3h .section-9 path{fill:hsl(180, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .section-9 text{fill:black;}#mermaid-svg-owXeqFLSEdBFmI3h .node-icon-9{font-size:40px;color:black;}#mermaid-svg-owXeqFLSEdBFmI3h .section-edge-9{stroke:hsl(180, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .edge-depth-9{stroke-width:-13;}#mermaid-svg-owXeqFLSEdBFmI3h .section-9 line{stroke:hsl(0, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled,#mermaid-svg-owXeqFLSEdBFmI3h .disabled circle,#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:lightgray;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:#efefef;}#mermaid-svg-owXeqFLSEdBFmI3h .section-10 rect,#mermaid-svg-owXeqFLSEdBFmI3h .section-10 path,#mermaid-svg-owXeqFLSEdBFmI3h .section-10 circle,#mermaid-svg-owXeqFLSEdBFmI3h .section-10 polygon,#mermaid-svg-owXeqFLSEdBFmI3h .section-10 path{fill:hsl(210, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .section-10 text{fill:black;}#mermaid-svg-owXeqFLSEdBFmI3h .node-icon-10{font-size:40px;color:black;}#mermaid-svg-owXeqFLSEdBFmI3h .section-edge-10{stroke:hsl(210, 100%, 76.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .edge-depth-10{stroke-width:-16;}#mermaid-svg-owXeqFLSEdBFmI3h .section-10 line{stroke:hsl(30, 100%, 86.2745098039%);stroke-width:3;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled,#mermaid-svg-owXeqFLSEdBFmI3h .disabled circle,#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:lightgray;}#mermaid-svg-owXeqFLSEdBFmI3h .disabled text{fill:#efefef;}#mermaid-svg-owXeqFLSEdBFmI3h .section-root rect,#mermaid-svg-owXeqFLSEdBFmI3h .section-root path,#mermaid-svg-owXeqFLSEdBFmI3h .section-root circle,#mermaid-svg-owXeqFLSEdBFmI3h .section-root polygon{fill:hsl(240, 100%, 46.2745098039%);}#mermaid-svg-owXeqFLSEdBFmI3h .section-root text{fill:#ffffff;}#mermaid-svg-owXeqFLSEdBFmI3h .section-root span{color:#ffffff;}#mermaid-svg-owXeqFLSEdBFmI3h .section-2 span{color:#ffffff;}#mermaid-svg-owXeqFLSEdBFmI3h .icon-container{height:100%;display:flex;justify-content:center;align-items:center;}#mermaid-svg-owXeqFLSEdBFmI3h .edge{fill:none;}#mermaid-svg-owXeqFLSEdBFmI3h .mindmap-node-label{dy:1em;alignment-baseline:middle;text-anchor:middle;dominant-baseline:middle;text-align:center;}#mermaid-svg-owXeqFLSEdBFmI3h :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

包粽子模拟器未来演进

技术升级

AR增强现实

VR沉浸体验

手势交互

语音指导

功能扩展

多人在线协作

文化大数据

个性化推荐

教学模式

文化深化

非遗传承人入驻

地域文化专题

节日全流程

海外变体展示

产业融合

粽子电商对接

线下体验引流

文创产品

文化旅游

8.5 结语：代码与文化的对话

端午节粽子文化历经两千余年传承，从竹筒贮米到粽叶包裹，从祭祀用品到节庆美食，其形态与功能不断演变，但"包裹"与"分享"的核心精神始终未变。用Python代码模拟包粽子，是这一古老文化在数字时代的最新演变——代码成为了新的"粽叶"，包裹着传统文化的内容；屏幕成为了新的"餐桌"，分享着文化传承的体验。

技术从不与文化对立，真正的技术创新应当服务于文化传承。当一行行Python代码渲染出翠绿的粽叶、雪白的糯米、金黄的蛋黄，当用户通过键盘操作完成一个"虚拟粽子"的制作，传统文化便在数字世界中获得了新的生命力。这或许就是"端午节粽子文化与Python包粽子模拟器"最深层的意义——让千年粽香，在代码的世界里继续飘荡。

完整代码实现：

# -*- coding: utf-8 -*-
"""
端午节包粽子模拟器 – main.py
基于Python + Pygame实现的包粽子交互式模拟器
兼容Windows系统中文字符显示

运行方式: python main.py
依赖: pip install pygame

操作说明:
– 鼠标点击: 选择馅料、按钮
– 空格键: 添加糯米
– 回车键: 折叠粽叶/系绳/煮制
– ESC键: 返回上一级/退出
– R键: 重新开始
"""

import pygame
import sys
import random
import math
import os

# ==================== 全局配置 ====================
WINDOW_WIDTH = 1024
WINDOW_HEIGHT = 720
FPS = 60

# 颜色定义 (R, G, B)
COLOR_BG = (245, 235, 215)
COLOR_TITLE = (139, 69, 19)
COLOR_TEXT = (60, 40, 20)
COLOR_LEAF = (76, 120, 60)
COLOR_LEAF_DARK = (45, 80, 35)
COLOR_RICE = (255, 250, 230)
COLOR_RICE_COOKED = (240, 210, 150)
COLOR_FILLING_MEAT = (180, 90, 70)
COLOR_FILLING_EGG = (255, 200, 50)
COLOR_FILLING_BEAN = (160, 90, 50)
COLOR_FILLING_DATE = (180, 50, 40)
COLOR_STRING = (200, 160, 100)
COLOR_BUTTON = (180, 100, 60)
COLOR_BUTTON_HOVER = (210, 130, 80)
COLOR_BUTTON_TEXT = (255, 250, 240)
COLOR_PANEL = (255, 248, 230)
COLOR_SUCCESS = (60, 140, 80)
COLOR_WARN = (200, 80, 60)
COLOR_PROGRESS_BG = (220, 200, 170)
COLOR_PROGRESS = (120, 180, 90)

# 游戏状态
STATE_MENU = 0
STATE_SELECT_FILLING = 1
STATE_FOLD_LEAF = 2
STATE_ADD_RICE = 3
STATE_ADD_FILLING = 4
STATE_TIE_STRING = 5
STATE_COOK = 6
STATE_RESULT = 7

# 粽子馅料类型
FILLINGS = {
"red_date": {"name": "红枣粽", "color": COLOR_FILLING_DATE, "region": "北方", "desc": "经典甜粽，红枣软糯"},
"meat": {"name": "鲜肉粽", "color": COLOR_FILLING_MEAT, "region": "江南", "desc": "嘉兴名点，肥而不腻"},
"egg_yolk": {"name": "蛋黄粽", "color": COLOR_FILLING_EGG, "region": "广东", "desc": "咸香浓郁，金黄诱人"},
"bean_paste": {"name": "豆沙粽", "color": COLOR_FILLING_BEAN, "region": "江南", "desc": "细腻甜润，入口即化"},
}

class ZongziSimulator:
"""包粽子模拟器主类"""

def __init__(self):
pygame.init()
try:
pygame.mixer.init()
except Exception:
pass # 无音频环境时跳过

self.screen = pygame.display.set_mode((WINDOW_WIDTH, WINDOW_HEIGHT))
pygame.display.set_caption("端午节包粽子模拟器 – Dragon Boat Festival Zongzi Simulator")
self.clock = pygame.time.Clock()

# 字体设置 – 兼容Windows和Linux
self.font_title = self._get_font(48, bold=True)
self.font_large = self._get_font(36, bold=True)
self.font_medium = self._get_font(24)
self.font_small = self._get_font(18)
self.font_tiny = self._get_font(14)

# 游戏状态
self.state = STATE_MENU
self.score = 0
self.zongzi_count = 0

# 当前粽子制作状态
self.current_filling = None
self.rice_amount = 0.0
self.leaf_fold_angle = 0
self.string_wraps = 0
self.cooking_time = 0
self.progress = 0
self.result_quality = ""
self.result_score = 0

# 动画相关
self.animation_time = 0
self.particles = []
self.message = ""
self.message_timer = 0

# 鼠标
self.mouse_pos = (0, 0)
self.mouse_clicked = False

def _get_font(self, size, bold=False):
"""获取兼容中文字体（优先从Windows字体目录直接加载）"""
# 先尝试直接从Windows Fonts目录加载常用中文字体文件
font_dirs = [
os.path.join(os.environ.get("WINDIR", "C:\\\\Windows"), "Fonts"),
"/usr/share/fonts",
"/System/Library/Fonts",
]
font_files = [
"msyh.ttc", "msyhbd.ttc", # 微软雅黑
"simhei.ttf", # 黑体
"simsun.ttc", # 宋体
"simfang.ttf", # 仿宋
"Deng.ttf", "Dengb.ttf", # 等线
"YaHei.ttf", "YaHeib.ttf", # 微软雅黑（备选名）
"NotoSansCJKsc-Regular.otf", # 思源黑体
"wqy-microhei.ttc", # 文泉驿（Linux）
]
for font_dir in font_dirs:
if os.path.isdir(font_dir):
for fname in font_files:
fpath = os.path.join(font_dir, fname)
if os.path.isfile(fpath):
try:
font = pygame.font.Font(fpath, size)
test = font.render("粽", True, (0, 0, 0))
if test.get_width() > 0:
return font
except Exception:
continue
# 后备：使用SysFont（带正确字体名称）
font_candidates = [
"Microsoft YaHei", "Microsoft YaHei UI", "微软雅黑",
"SimHei", "黑体", "SimSun", "宋体", "DengXian", "等线",
"NSimSun", "FangSong", "KaiTi",
"microsoftyahei", "msyh", "simhei", "simsun",
"notosanscjksc", "notosanssc", "wenquanyimicrohei",
"wqy-microhei", "arialunicodems", "dejavusans", "arial"
]
for font_name in font_candidates:
try:
font = pygame.font.SysFont(font_name, size, bold=bold)
test = font.render("粽", True, (0, 0, 0))
if test.get_width() > 0:
return font
except Exception:
continue
return pygame.font.Font(None, size)

def run(self):
"""主循环"""
running = True
while running:
dt = self.clock.tick(FPS) / 1000.0
self.animation_time += dt

# 事件处理
self.mouse_clicked = False
for event in pygame.event.get():
if event.type == pygame.QUIT:
running = False
elif event.type == pygame.MOUSEMOTION:
self.mouse_pos = event.pos
elif event.type == pygame.MOUSEBUTTONDOWN and event.button == 1:
self.mouse_pos = event.pos
self.mouse_clicked = True
elif event.type == pygame.KEYDOWN:
if event.key == pygame.K_ESCAPE:
if self.state == STATE_MENU:
running = False
else:
self.state = STATE_MENU
self._reset_current()
elif event.key == pygame.K_SPACE:
self._handle_space()
elif event.key == pygame.K_RETURN:
self._handle_enter()
elif event.key == pygame.K_r:
self._reset_current()
self.state = STATE_MENU

# 更新
self._update(dt)
# 绘制
self._draw()
pygame.display.flip()

pygame.quit()

def _reset_current(self):
"""重置当前粽子制作状态"""
self.current_filling = None
self.rice_amount = 0.0
self.leaf_fold_angle = 0
self.string_wraps = 0
self.cooking_time = 0
self.progress = 0
self.result_quality = ""
self.result_score = 0
self.particles = []

def _handle_space(self):
"""空格键处理"""
if self.state == STATE_ADD_RICE:
if self.rice_amount < 1.0:
self.rice_amount = min(1.0, self.rice_amount + 0.1)
self._add_particles(WINDOW_WIDTH // 2, WINDOW_HEIGHT // 2, COLOR_RICE, 5)
self._show_message("添加糯米 +10%", 1.0)

def _handle_enter(self):
"""回车键处理"""
if self.state == STATE_FOLD_LEAF:
if self.leaf_fold_angle < 90:
self.leaf_fold_angle = min(90, self.leaf_fold_angle + 15)
self._show_message(f"折叠粽叶 {self.leaf_fold_angle}°", 1.0)
if self.leaf_fold_angle >= 90:
self.state = STATE_ADD_RICE
self._show_message("进入加米环节", 1.5)
elif self.state == STATE_ADD_RICE:
if self.rice_amount > 0.3:
self.state = STATE_ADD_FILLING
self._show_message("进入加馅环节", 1.5)
else:
self._show_message("糯米太少，请多加一些!", 1.5)
elif self.state == STATE_ADD_FILLING:
self.state = STATE_TIE_STRING
self._show_message("进入系绳环节", 1.5)
elif self.state == STATE_TIE_STRING:
if self.string_wraps < 5:
self.string_wraps += 1
self._show_message(f"缠绕粽绳 第{self.string_wraps}圈", 1.0)
if self.string_wraps >= 3:
self.state = STATE_COOK
self._show_message("开始煮制!", 1.5)
else:
self.state = STATE_COOK
elif self.state == STATE_COOK:
self._calculate_result()
self.state = STATE_RESULT
elif self.state == STATE_RESULT:
self._reset_current()
self.state = STATE_MENU

def _update(self, dt):
"""更新游戏状态"""
if self.message_timer > 0:
self.message_timer -= dt

# 更新粒子
for p in self.particles[:]:
p['x'] += p['vx'] * dt
p['y'] += p['vy'] * dt
p['vy'] += 200 * dt # 重力
p['life'] -= dt
if p['life'] <= 0:
self.particles.remove(p)

# 煮制进度
if self.state == STATE_COOK and self.progress < 1.0:
self.progress = min(1.0, self.progress + dt * 0.3)
if self.progress >= 1.0:
self._calculate_result()
self.state = STATE_RESULT

# 菜单状态点击处理
if self.mouse_clicked and self.state == STATE_MENU:
if self._check_button_click(WINDOW_WIDTH // 2 – 120, 400, 240, 60):
self.state = STATE_SELECT_FILLING
self._show_message("选择你喜欢的馅料", 2.0)

# 选择馅料
if self.mouse_clicked and self.state == STATE_SELECT_FILLING:
filling_keys = list(FILLINGS.keys())
for i, key in enumerate(filling_keys):
bx = 150 + i * 200
by = 300
if self._check_button_click(bx, by, 160, 200):
self.current_filling = key
self.state = STATE_FOLD_LEAF
self._show_message(f"选择了{FILLINGS[key]['name']}", 2.0)
break

def _check_button_click(self, x, y, w, h):
"""检查鼠标是否点击按钮区域"""
mx, my = self.mouse_pos
return x <= mx <= x + w and y <= my <= y + h

def _add_particles(self, x, y, color, count):
"""添加粒子效果"""
for _ in range(count):
self.particles.append({
'x': x + random.randint(–20, 20),
'y': y + random.randint(–20, 20),
'vx': random.uniform(–100, 100),
'vy': random.uniform(–150, –50),
'color': color,
'size': random.randint(3, 6),
'life': random.uniform(0.5, 1.0)
})

def _show_message(self, msg, duration=1.5):
"""显示临时消息"""
self.message = msg
self.message_timer = duration

def _calculate_result(self):
"""计算制作结果"""
score = 100
if self.rice_amount < 0.7:
score -= 20
elif self.rice_amount > 0.95:
score -= 10
if self.string_wraps < 2:
score -= 30
elif self.string_wraps < 3:
score -= 10
if self.leaf_fold_angle < 50:
score -= 15

self.result_score = max(0, score)
if score >= 90:
self.result_quality = "优秀 – 完美粽子!"
elif score >= 75:
self.result_quality = "良好 – 美味可口"
elif score >= 60:
self.result_quality = "合格 – 还能入口"
else:
self.result_quality = "待改进 – 继续努力"

self.score += self.result_score
self.zongzi_count += 1

def _draw(self):
"""绘制界面"""
self.screen.fill(COLOR_BG)

# 绘制装饰背景
self._draw_background_decoration()

if self.state == STATE_MENU:
self._draw_menu()
elif self.state == STATE_SELECT_FILLING:
self._draw_select_filling()
elif self.state == STATE_FOLD_LEAF:
self._draw_fold_leaf()
elif self.state == STATE_ADD_RICE:
self._draw_add_rice()
elif self.state == STATE_ADD_FILLING:
self._draw_add_filling()
elif self.state == STATE_TIE_STRING:
self._draw_tie_string()
elif self.state == STATE_COOK:
self._draw_cook()
elif self.state == STATE_RESULT:
self._draw_result()

# 绘制粒子
self._draw_particles()

# 绘制消息
if self.message_timer > 0:
self._draw_message()

# 绘制状态栏
self._draw_status_bar()

def _draw_background_decoration(self):
"""绘制背景装饰"""
# 绘制粽叶纹理
for i in range(5):
x = 50 + i * 200
y = 50
points = [
(x, y), (x + 80, y + 20), (x + 60, y + 100), (x – 20, y + 80)
]
pygame.draw.polygon(self.screen, COLOR_LEAF_DARK, points, 2)

def _draw_menu(self):
"""绘制主菜单"""
# 标题
title = self.font_title.render("端午节包粽子模拟器", True, COLOR_TITLE)
self.screen.blit(title, (WINDOW_WIDTH // 2 – title.get_width() // 2, 150))

subtitle = self.font_medium.render("Dragon Boat Festival Zongzi Simulator", True, COLOR_TEXT)
self.screen.blit(subtitle, (WINDOW_WIDTH // 2 – subtitle.get_width() // 2, 210))

# 装饰粽子
self._draw_zongzi_icon(WINDOW_WIDTH // 2, 320, 60)

# 开始按钮
self._draw_button(WINDOW_WIDTH // 2 – 120, 400, 240, 60, "开始包粽子", 24)

# 说明文字
instructions = [
"操作说明:",
" 鼠标点击 – 选择馅料/按钮",
" 空格键 – 添加糯米",
" 回车键 – 折叠粽叶/系绳/煮制",
" ESC键 – 返回/退出",
" R键 – 重新开始",
]
for i, text in enumerate(instructions):
txt = self.font_small.render(text, True, COLOR_TEXT)
self.screen.blit(txt, (WINDOW_WIDTH // 2 – 150, 500 + i * 25))

def _draw_select_filling(self):
"""绘制选择馅料界面"""
title = self.font_large.render("选择你喜欢的粽子馅料", True, COLOR_TITLE)
self.screen.blit(title, (WINDOW_WIDTH // 2 – title.get_width() // 2, 100))

filling_keys = list(FILLINGS.keys())
for i, key in enumerate(filling_keys):
filling = FILLINGS[key]
bx = 150 + i * 200
by = 300

# 卡片背景
rect = pygame.Rect(bx, by, 160, 200)
pygame.draw.rect(self.screen, COLOR_PANEL, rect, border_radius=10)
pygame.draw.rect(self.screen, COLOR_LEAF, rect, 3, border_radius=10)

# 馅料颜色圆
pygame.draw.circle(self.screen, filling["color"], (bx + 80, by + 60), 30)
pygame.draw.circle(self.screen, COLOR_TEXT, (bx + 80, by + 60), 30, 2)

# 名称
name = self.font_medium.render(filling["name"], True, COLOR_TEXT)
self.screen.blit(name, (bx + 80 – name.get_width() // 2, by + 105))

# 地区
region = self.font_small.render(f"【{filling['region']}】", True, COLOR_TITLE)
self.screen.blit(region, (bx + 80 – region.get_width() // 2, by + 135))

# 描述
desc = self.font_tiny.render(filling["desc"], True, COLOR_TEXT)
self.screen.blit(desc, (bx + 80 – desc.get_width() // 2, by + 165))

def _draw_fold_leaf(self):
"""绘制折叠粽叶界面"""
title = self.font_large.render("第一步: 折叠粽叶", True, COLOR_TITLE)
self.screen.blit(title, (WINDOW_WIDTH // 2 – title.get_width() // 2, 80))

hint = self.font_medium.render("按回车键折叠粽叶 (目标: 90°)", True, COLOR_TEXT)
self.screen.blit(hint, (WINDOW_WIDTH // 2 – hint.get_width() // 2, 140))

# 绘制粽叶
cx, cy = WINDOW_WIDTH // 2, 380
angle = self.leaf_fold_angle

# 粽叶形状(三角形)
leaf_points = [
(cx – 100, cy + 80),
(cx + 100, cy + 80),
(cx, cy – 80 + int(angle * 0.5))
]
pygame.draw.polygon(self.screen, COLOR_LEAF, leaf_points)
pygame.draw.polygon(self.screen, COLOR_LEAF_DARK, leaf_points, 3)

# 折叠角度显示
angle_text = self.font_large.render(f"折叠角度: {angle}°", True, COLOR_TITLE)
self.screen.blit(angle_text, (WINDOW_WIDTH // 2 – angle_text.get_width() // 2, 500))

# 进度条
self._draw_progress_bar(WINDOW_WIDTH // 2 – 150, 560, 300, 20, angle / 90.0)

def _draw_add_rice(self):
"""绘制添加糯米界面"""
title = self.font_large.render("第二步: 添加糯米", True, COLOR_TITLE)
self.screen.blit(title, (WINDOW_WIDTH // 2 – title.get_width() // 2, 80))

hint = self.font_medium.render("按空格键添加糯米 (推荐: 70%-95%)", True, COLOR_TEXT)
self.screen.blit(hint, (WINDOW_WIDTH // 2 – hint.get_width() // 2, 140))

# 绘制粽子容器
cx, cy = WINDOW_WIDTH // 2, 380
container_points = [
(cx – 120, cy + 80),
(cx + 120, cy + 80),
(cx + 80, cy – 60),
(cx – 80, cy – 60)
]
pygame.draw.polygon(self.screen, COLOR_LEAF, container_points)
pygame.draw.polygon(self.screen, COLOR_LEAF_DARK, container_points, 3)

# 绘制糯米
if self.rice_amount > 0:
rice_height = int(140 * self.rice_amount)
rice_rect = pygame.Rect(cx – 70, cy + 80 – rice_height, 140, rice_height)
pygame.draw.rect(self.screen, COLOR_RICE, rice_rect)

# 糯米量显示
amount_text = self.font_large.render(f"糯米量: {int(self.rice_amount * 100)}%", True, COLOR_TITLE)
self.screen.blit(amount_text, (WINDOW_WIDTH // 2 – amount_text.get_width() // 2, 500))

# 进度条
self._draw_progress_bar(WINDOW_WIDTH // 2 – 150, 560, 300, 20, self.rice_amount)

# 完成提示
if self.rice_amount > 0.3:
tip = self.font_small.render("按回车键进入下一步", True, COLOR_SUCCESS)
self.screen.blit(tip, (WINDOW_WIDTH // 2 – tip.get_width() // 2, 600))

def _draw_add_filling(self):
"""绘制添加馅料界面"""
title = self.font_large.render("第三步: 添加馅料", True, COLOR_TITLE)
self.screen.blit(title, (WINDOW_WIDTH // 2 – title.get_width() // 2, 80))

hint = self.font_medium.render("按回车键放入馅料", True, COLOR_TEXT)
self.screen.blit(hint, (WINDOW_WIDTH // 2 – hint.get_width() // 2, 140))

# 绘制粽子
cx, cy = WINDOW_WIDTH // 2, 380
container_points = [
(cx – 120, cy + 80),
(cx + 120, cy + 80),
(cx + 80, cy – 60),
(cx – 80, cy – 60)
]
pygame.draw.polygon(self.screen, COLOR_LEAF, container_points)
pygame.draw.polygon(self.screen, COLOR_LEAF_DARK, container_points, 3)

# 糯米
rice_height = int(140 * self.rice_amount)
rice_rect = pygame.Rect(cx – 70, cy + 80 – rice_height, 140, rice_height)
pygame.draw.rect(self.screen, COLOR_RICE, rice_rect)

# 馅料
if self.current_filling:
filling = FILLINGS[self.current_filling]
pygame.draw.circle(self.screen, filling["color"], (cx, cy + 20), 25)
pygame.draw.circle(self.screen, COLOR_TEXT, (cx, cy + 20), 25, 2)

name = self.font_medium.render(filling["name"], True, COLOR_TITLE)
self.screen.blit(name, (WINDOW_WIDTH // 2 – name.get_width() // 2, 500))

def _draw_tie_string(self):
"""绘制系绳界面"""
title = self.font_large.render("第四步: 缠绕粽绳", True, COLOR_TITLE)
self.screen.blit(title, (WINDOW_WIDTH // 2 – title.get_width() // 2, 80))

hint = self.font_medium.render("按回车键缠绕粽绳 (至少3圈)", True, COLOR_TEXT)
self.screen.blit(hint, (WINDOW_WIDTH // 2 – hint.get_width() // 2, 140))

# 绘制粽子
cx, cy = WINDOW_WIDTH // 2, 380
pygame.draw.polygon(self.screen, COLOR_LEAF,
[(cx – 100, cy + 70), (cx + 100, cy + 70), (cx + 70, cy – 50), (cx – 70, cy – 50)])
pygame.draw.polygon(self.screen, COLOR_LEAF_DARK,
[(cx – 100, cy + 70), (cx + 100, cy + 70), (cx + 70, cy – 50), (cx – 70, cy – 50)], 3)

# 绘制粽绳
for i in range(self.string_wraps):
y_offset = –40 + i * 25
pygame.draw.line(self.screen, COLOR_STRING, (cx – 90, cy + y_offset), (cx + 90, cy + y_offset), 4)
pygame.draw.line(self.screen, (140, 100, 60), (cx – 90, cy + y_offset), (cx + 90, cy + y_offset), 1)

wraps_text = self.font_large.render(f"粽绳圈数: {self.string_wraps}", True, COLOR_TITLE)
self.screen.blit(wraps_text, (WINDOW_WIDTH // 2 – wraps_text.get_width() // 2, 500))

if self.string_wraps >= 3:
tip = self.font_small.render("按回车键开始煮制!", True, COLOR_SUCCESS)
self.screen.blit(tip, (WINDOW_WIDTH // 2 – tip.get_width() // 2, 600))

def _draw_cook(self):
"""绘制煮制界面"""
title = self.font_large.render("第五步: 煮制粽子", True, COLOR_TITLE)
self.screen.blit(title, (WINDOW_WIDTH // 2 – title.get_width() // 2, 80))

# 绘制锅
cx, cy = WINDOW_WIDTH // 2, 350
pygame.draw.ellipse(self.screen, (80, 80, 80), (cx – 150, cy – 30, 300, 100))
pygame.draw.ellipse(self.screen, (40, 40, 40), (cx – 150, cy – 30, 300, 100), 4)

# 水
water_color = (
int(100 + 50 * self.progress),
int(150 + 50 * self.progress),
int(200 – 50 * self.progress)
)
pygame.draw.ellipse(self.screen, water_color, (cx – 140, cy – 20, 280, 80))

# 粽子
zongzi_color = (
int(COLOR_LEAF[0] + (COLOR_LEAF_DARK[0] – COLOR_LEAF[0]) * self.progress),
int(COLOR_LEAF[1] + (COLOR_LEAF_DARK[1] – COLOR_LEAF[1]) * self.progress),
int(COLOR_LEAF[2] + (COLOR_LEAF_DARK[2] – COLOR_LEAF[2]) * self.progress)
)
pygame.draw.polygon(self.screen, zongzi_color,
[(cx – 50, cy + 30), (cx + 50, cy + 30), (cx + 30, cy – 10), (cx – 30, cy – 10)])

# 蒸汽
if self.progress > 0.3:
for i in range(3):
steam_x = cx – 40 + i * 40
steam_y = cy – 40 – int(self.animation_time * 30) % 60
alpha = max(0, 150 – int(self.animation_time * 30) % 60 * 2)
steam_surf = pygame.Surface((30, 30), pygame.SRCALPHA)
pygame.draw.circle(steam_surf, (255, 255, 255, alpha), (15, 15), 15)
self.screen.blit(steam_surf, (steam_x – 15, steam_y – 15))

# 进度
progress_text = self.font_large.render(f"煮制进度: {int(self.progress * 100)}%", True, COLOR_TITLE)
self.screen.blit(progress_text, (WINDOW_WIDTH // 2 – progress_text.get_width() // 2, 500))

self._draw_progress_bar(WINDOW_WIDTH // 2 – 150, 560, 300, 20, self.progress)

def _draw_result(self):
"""绘制结果界面"""
title = self.font_large.render("粽子制作完成!", True, COLOR_TITLE)
self.screen.blit(title, (WINDOW_WIDTH // 2 – title.get_width() // 2, 100))

# 绘制完成的粽子
self._draw_zongzi_icon(WINDOW_WIDTH // 2, 280, 80)

# 结果
quality_color = COLOR_SUCCESS if self.result_score >= 75 else (COLOR_WARN if self.result_score < 60 else COLOR_TITLE)
quality = self.font_large.render(self.result_quality, True, quality_color)
self.screen.blit(quality, (WINDOW_WIDTH // 2 – quality.get_width() // 2, 400))

score_text = self.font_title.render(f"得分: {self.result_score}", True, COLOR_TITLE)
self.screen.blit(score_text, (WINDOW_WIDTH // 2 – score_text.get_width() // 2, 460))

# 馅料信息
if self.current_filling:
filling = FILLINGS[self.current_filling]
info = self.font_medium.render(f"馅料: {filling['name']} ({filling['region']})", True, COLOR_TEXT)
self.screen.blit(info, (WINDOW_WIDTH // 2 – info.get_width() // 2, 540))

# 统计
stats = self.font_small.render(f"累计得分: {self.score} | 已包粽子: {self.zongzi_count}个", True, COLOR_TEXT)
self.screen.blit(stats, (WINDOW_WIDTH // 2 – stats.get_width() // 2, 580))

tip = self.font_medium.render("按回车键继续包粽子 | ESC返回菜单", True, COLOR_SUCCESS)
self.screen.blit(tip, (WINDOW_WIDTH // 2 – tip.get_width() // 2, 630))

def _draw_zongzi_icon(self, cx, cy, size):
"""绘制粽子图标"""
points = [
(cx, cy – size),
(cx + size * 0.866, cy + size * 0.5),
(cx – size * 0.866, cy + size * 0.5)
]
pygame.draw.polygon(self.screen, COLOR_LEAF, points)
pygame.draw.polygon(self.screen, COLOR_LEAF_DARK, points, 3)

# 粽绳
pygame.draw.line(self.screen, COLOR_STRING, (cx – size * 0.7, cy), (cx + size * 0.7, cy), 3)
pygame.draw.line(self.screen, COLOR_STRING, (cx – size * 0.5, cy – size * 0.3), (cx + size * 0.5, cy + size * 0.3), 3)

def _draw_button(self, x, y, w, h, text, font_size=20):
"""绘制按钮"""
rect = pygame.Rect(x, y, w, h)
color = COLOR_BUTTON_HOVER if self._check_button_click(x, y, w, h) else COLOR_BUTTON
pygame.draw.rect(self.screen, color, rect, border_radius=10)
pygame.draw.rect(self.screen, COLOR_LEAF_DARK, rect, 3, border_radius=10)

font = self.font_medium if font_size >= 20 else self.font_small
txt = font.render(text, True, COLOR_BUTTON_TEXT)
self.screen.blit(txt, (x + w // 2 – txt.get_width() // 2, y + h // 2 – txt.get_height() // 2))

def _draw_progress_bar(self, x, y, w, h, progress):
"""绘制进度条"""
pygame.draw.rect(self.screen, COLOR_PROGRESS_BG, (x, y, w, h), border_radius=5)
if progress > 0:
fill_w = int(w * progress)
pygame.draw.rect(self.screen, COLOR_PROGRESS, (x, y, fill_w, h), border_radius=5)
pygame.draw.rect(self.screen, COLOR_TEXT, (x, y, w, h), 2, border_radius=5)

def _draw_particles(self):
"""绘制粒子"""
for p in self.particles:
alpha = max(0, min(255, int(p['life'] * 255)))
surf = pygame.Surface((p['size'] * 2, p['size'] * 2), pygame.SRCALPHA)
pygame.draw.circle(surf, (*p['color'], alpha), (p['size'], p['size']), p['size'])
self.screen.blit(surf, (p['x'] – p['size'], p['y'] – p['size']))

def _draw_message(self):
"""绘制消息"""
alpha = min(255, int(self.message_timer * 200))
msg_surf = self.font_medium.render(self.message, True, COLOR_WARN)
msg_surf.set_alpha(alpha)
x = WINDOW_WIDTH // 2 – msg_surf.get_width() // 2
y = 50
self.screen.blit(msg_surf, (x, y))

def _draw_status_bar(self):
"""绘制底部状态栏"""
pygame.draw.rect(self.screen, COLOR_PANEL, (0, WINDOW_HEIGHT – 40, WINDOW_WIDTH, 40))
pygame.draw.line(self.screen, COLOR_LEAF_DARK, (0, WINDOW_HEIGHT – 40), (WINDOW_WIDTH, WINDOW_HEIGHT – 40), 2)

state_names = {
STATE_MENU: "主菜单",
STATE_SELECT_FILLING: "选择馅料",
STATE_FOLD_LEAF: "折叠粽叶",
STATE_ADD_RICE: "添加糯米",
STATE_ADD_FILLING: "添加馅料",
STATE_TIE_STRING: "缠绕粽绳",
STATE_COOK: "煮制中",
STATE_RESULT: "制作完成"
}
state_text = self.font_small.render(f"当前步骤: {state_names.get(self.state, '未知')}", True, COLOR_TEXT)
self.screen.blit(state_text, (20, WINDOW_HEIGHT – 30))

score_text = self.font_small.render(f"得分: {self.score} | 粽子: {self.zongzi_count}", True, COLOR_TITLE)
self.screen.blit(score_text, (WINDOW_WIDTH – score_text.get_width() – 20, WINDOW_HEIGHT – 30))

def main():
"""主函数"""
print("=" * 50)
print(" 端午节包粽子模拟器")
print(" Dragon Boat Festival Zongzi Simulator")
print("=" * 50)
print()

try:
simulator = ZongziSimulator()
simulator.run()
except Exception as e:
print(f"运行出错: {e}")
import traceback
traceback.print_exc()
sys.exit(1)

print()
print("感谢使用端午节包粽子模拟器!")
print(f"总得分: {simulator.score}")
print(f"共包了 {simulator.zongzi_count} 个粽子")
print("祝您端午安康!")

if __name__ == "__main__":
main()

[1] 高丙中. 端午节是中国人的认同文化[N]. 北京大学新闻, 2024. 链接: https://news.pku.edu.cn/bdrw/137-115135.htm

[2] 福州市人民政府. 端午节的起源[EB/OL]. 民俗风情, 2021. 链接: https://www.fuzhou.gov.cn/zgfzzt/zjrc/mdfc/msfq/202111/t20211123_4251105.htm

[3] 中国民俗学会. 端午节研究的历史回顾[R]. 2013. 链接: https://www.chinesefolklore.org.cn/upload/news/Attach-20130612100414.pdf

[4] 云南非物质文化遗产保护网. 端午节习俗：北方吃甜粽南方吃咸粽[EB/OL]. 链接: https://www.ynich.cn/news/new/1555.html

[5] UNESCO. Dragon Boat Festival inscribed on Representative List of Intangible Cultural Heritage[Z]. 2009. 链接: http://www.china.org.cn/arts/2024-06/07/content_117239785.htm

[6] 北京理工大学. Python游戏开发入门[MOOC]. 链接: https://www.icourse163.org/learn/BIT-1001873001