一款采用「深空霓虹」暗色主题打造的 2048 数字合成游戏，Python + Pygame 驱动，专为 Windows 桌面而生。
当前版本: v0.0.1 · English · 日本語 · 繁體中文 · 한국어 · Français · Deutsch · Español · Português · Русский · Italiano · Nederlands · Türkçe · Tiếng Việt · ภาษาไทย · Bahasa Indonesia · हिन्दी · العربية
| 语言 | 文档 |
|---|---|
| 简体中文 (当前) | README.md |
| English | README.en.md |
| 日本語 | README.ja.md |
| 繁體中文 | README.zh-TW.md |
| 한국어 | README.ko.md |
| Français | README.fr.md |
| Deutsch | README.de.md |
| Español | README.es.md |
| Português | README.pt.md |
| Русский | README.ru.md |
| Italiano | README.it.md |
| Nederlands | README.nl.md |
| Türkçe | README.tr.md |
| Tiếng Việt | README.vi.md |
| ภาษาไทย | README.th.md |
| Bahasa Indonesia | README.id.md |
| हिन्दी | README.hi.md |
| العربية | README.ar.md |
- 🎨 深空霓虹主题：深靛蓝渐变背景 + 动态漂移光斑 + 玻璃拟态卡片；方块自带渐变、轮辋光与顶部光泽，128 以上方块带霓虹辉光
- ⚡ 丝滑操作：输入队列 + 按住连滑（约每秒 7 步）+ 帧率无关动画，快速连击不丢步
- 💥 动效特效：合并粒子爆发、大方块合成震屏、胜利彩带、结束过渡动画、页面淡入淡出
- 🌍 双语界面：游戏内一键切换中 / 英文
| 模式 | 说明 |
|---|---|
| 经典模式 | 不限时间，挑战最高分 |
| 限时模式 | 60 秒内冲击目标分数 |
| 挑战模式 | 50 步内合成 128 方块 |
操作方式：方向键 / WASD / 鼠标滑动 · ESC 暂停
- 撤销：回退上一步（每局 3 次）
- 清理：清除一个最小方块（每局 1 次）
- 复活：游戏结束后移除两个最小方块继续对局
- 成就系统（6 项成就待解锁）
- 最高分 / 总局数统计
- 结算页新纪录徽章 + 得分滚动动画
- 音效与背景音乐开关
- Windows 10 / 11
- Python 3.10+
- Pygame 2.6.1
pip install -r requirements.txtpython src/main.py# 一键打包（推荐）
python scripts/build_auto.py
# 交互式打包
python scripts/build.py打包完成后，可执行文件位于 dist/2048/2048.exe，双击即玩，无需安装 Python 或任何依赖。详见 scripts/README.md。
2048/
├── src/ # 源代码
│ ├── main.py # 入口文件
│ ├── config.py # 全局配置（主题 / 动画 / 输入）
│ ├── i18n.py # 多语言（中英）
│ ├── utils.py # 绘图助手、缓存、动画曲线
│ ├── models/ # 数据模型（棋盘 / 状态 / 存档 / 成就）
│ └── views/ # 视图层
│ ├── ui_components.py # UI 组件（按钮 / 分数卡 / 开关 / 弹窗）
│ ├── board_view.py # 棋盘渲染与动画
│ ├── effects.py # 粒子系统与震屏
│ ├── sound_manager.py # 音效管理
│ └── pages/ # 各页面（菜单 / 游戏 / 结算 / 设置 / 成就 / 暂停 / 登录）
├── tests/ # 测试（359 项单元测试 + E2E 用户模拟）
├── scripts/ # 构建与打包脚本
├── docs/ # 文档
├── private/ # 私有文件
├── dist/ # 打包输出（.gitignore）
├── build/ # 构建临时文件（.gitignore）
└── requirements.txt # 依赖列表
# 运行全部单元测试
python -m pytest tests/
# 真实用户全流程模拟（E2E）
python tests/e2e_user_simulation.py
# 页面截图（UI 验收）
python tests/capture_ui_review.py测试覆盖：棋盘算法、游戏状态、三种模式全生命周期、道具、暂停 / 重开、输入队列连击、压力测试与 60FPS 性能预算。
- 文件 / 函数命名：
lower_snake_case· 类名：PascalCase· 缩进：4 空格 · 行宽：最大 120 字符 - Git 提交：
<type>(<scope>): <subject>，type 取feat / fix / docs / style / refactor / test / chore
MIT License © 2026 MagicSquarekey
欢迎提交 Issue 和 Pull Request！
如有问题，请通过 GitHub Issues 联系。