game

一个轻量级小游戏仓库，包含多个可直接运行的网页游戏，以及一个基于 Pygame 的桌面版俄罗斯方块。

项目简介

这个仓库的目标很简单：

• 保持实现轻量
• 打开就能玩
• 不依赖复杂构建流程
• 适合作为练习、演示和小型玩法迭代的代码基础

当前仓库主要由 3 个单文件 HTML 游戏和 1 个 Python 游戏组成。

游戏列表

1. 超级玛丽

• 文件：mario.html
• 类型：单文件 HTML + CSS + 原生 Canvas / JavaScript
• 特点：像素街机风、关卡推进、敌人碰撞、计分与生命系统

运行方式：

• 直接用浏览器打开 mario.html
• 或在 PowerShell 中运行 Start-Process .\mario.html

2. 贪吃蛇

• 文件：snake.html
• 类型：单文件 HTML + CSS + 原生 Canvas / JavaScript
• 特点：霓虹玻璃风、连击、速度调节、暂停和最高分记录

运行方式：

• 直接用浏览器打开 snake.html
• 或在 PowerShell 中运行 Start-Process .\snake.html

3. 网页版俄罗斯方块

• 文件：tetris.html
• 类型：单文件 HTML + CSS + 原生 Canvas / JavaScript
• 特点：霓虹玻璃风、分数与等级系统、下一块预览、速度控制

运行方式：

• 直接用浏览器打开 tetris.html
• 或在 PowerShell 中运行 Start-Process .\tetris.html

4. Pygame 俄罗斯方块

• 文件：tetris.py
• 类型：Python + Pygame
• 特点：中文显示友好、键盘操作完整、支持调速、暂停、硬降和重开

运行方式：

• python .\tetris.py
• 或 py -3 .\tetris.py

运行前需要本机已安装 pygame。

技术栈

• HTML5
• CSS3
• 原生 JavaScript
• Canvas API
• Python 3
• Pygame

仓库特点

• 没有 package.json
• 没有 pyproject.toml
• 没有自动化测试目录
• 没有现成的 lint 配置
• 没有构建或打包步骤

也就是说，这个仓库更偏向“直接运行的小游戏集合”，而不是标准工程化项目。

校验与测试

当前仓库没有正式的 build / lint / test 基础设施。

可用的基础校验方式：

• Python 语法检查：python -m py_compile .\tetris.py
• HTML 游戏：通过浏览器手工验证玩法流程

当前不存在：

• 仓库原生的 test 命令
• 可运行的单个测试命令
• pytest / jest / vitest / playwright 等测试配置

建议的手工验证

mario.html

• 验证开始游戏
• 验证左右移动和跳跃
• 验证死亡与生命减少
• 验证通关与下一关切换

snake.html

• 验证开始、暂停、重新开始
• 验证方向控制
• 验证速度滑块
• 验证吃食物、死亡、最高分更新

tetris.html

• 验证开始、暂停、继续、结束、重开
• 验证左右移动、旋转、软降、硬降
• 验证分数、等级、下一块预览、速度调节

tetris.py

• 先运行 python -m py_compile .\tetris.py
• 再启动游戏验证窗口和中文显示
• 验证移动、旋转、硬降、暂停、重开、调速

适合继续扩展的方向

• 给网页游戏补充音效或背景音乐
• 为每个游戏增加更多关卡或模式
• 给仓库补充统一入口页
• 增加自动化测试或基础 lint 配置
• 为 Python 版本补充依赖说明

说明

如果你只是想快速体验：

• 网页游戏直接双击 HTML 文件即可
• Python 游戏确保安装 pygame 后运行 tetris.py

这个仓库刻意保持简单，适合快速改玩法、改 UI 和做小游戏实验。