# snake-game

**Repository Path**: wei-shuai/snake-game

## Basic Information

- **Project Name**: snake-game
- **Description**: 一个使用JavaScript实现的经典贪吃蛇游戏，具有多种游戏模式和难度选择
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2025-03-21
- **Last Updated**: 2025-03-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 贪吃蛇游戏 (Snake Game)

## 项目介绍
一个使用纯JavaScript实现的多功能贪吃蛇游戏，具有多种游戏模式、难度选择、特殊食物效果和完整的用户界面。游戏采用面向对象的设计方式，具有良好的代码结构和模块化组织。

## 功能特点

- **多种游戏模式**：
  - 经典模式：传统贪吃蛇游戏
  - 无边界模式：蛇可以穿过墙壁
  - 障碍物模式：游戏区域中有障碍物
  - 加速模式：随着分数增加，蛇的速度会自动提升

- **难度设置**：
  - 简单：适合初学者
  - 中等：适合有一定经验的玩家
  - 困难：挑战更大
  - 极限：最高难度挑战

- **特殊食物系统**：
  - 普通食物：增加1分和长度
  - 金苹果：增加3分和长度
  - 减速食物：暂时减慢速度
  - 加速食物：暂时增加速度
  - 反向食物：暂时反转控制
  - 穿墙食物：暂时获得穿墙能力
  - 缩短食物：减少长度但增加分数

- **完整UI系统**：
  - 主菜单、设置菜单、排行榜、游戏暂停菜单和游戏结束界面
  - 用户设置保存功能
  - 高分记录系统
  - 游戏教程

- **多种控制方式**：
  - 方向键控制
  - WASD键控制
  - 移动设备触屏控制

- **视觉定制**：
  - 多种游戏主题选择
  - 可开关网格显示
  - 可开关视觉特效

## 安装教程

1. 克隆或下载项目到本地
   ```
   git clone [仓库地址]
   ```

2. 启动本地服务器（必须通过HTTP服务器访问，而非直接打开文件）
   - 使用Python内置HTTP服务器:
     ```
     python -m http.server 8000
     ```
   - 或使用Node.js的http-server:
     ```
     npx http-server
     ```
   - 或使用其他任何HTTP服务器

3. 在浏览器中访问:
   ```
   http://localhost:8000
   ```

## 使用说明

1. **开始游戏**：在主菜单点击"开始游戏"按钮
2. **设置游戏参数**：在设置菜单中调整难度、游戏模式、声音和视觉选项
3. **游戏控制**：
   - 方向键或WASD控制蛇的移动方向
   - 空格键暂停游戏
   - 移动设备上可使用屏幕上的虚拟按钮
4. **查看排行榜**：点击主菜单中的"排行榜"按钮
5. **保存得分**：游戏结束后可以输入名字保存得分

## 技术架构

项目采用面向对象的设计模式，主要组件包括：

- **核心游戏逻辑**：
  - `Game`: 游戏主控制器
  - `Snake`: 蛇的行为和状态管理
  - `Food`: 食物生成和效果管理
  - `Board`: 游戏板和障碍物管理

- **用户界面**：
  - `UIManager`: 管理所有UI元素和交互
  - `Renderer`: 负责游戏画面渲染
  - `InputManager`: 处理用户输入
  - `SoundManager`: 管理游戏音效和音乐

- **工具类**：
  - `StorageManager`: 管理本地存储和数据持久化
  - 各种辅助函数和常量定义

## 浏览器兼容性

游戏兼容所有支持HTML5 Canvas和ES6的现代浏览器，包括但不限于：
- Google Chrome (推荐)
- Firefox
- Safari
- Edge

## 贡献指南

1. Fork 本仓库
2. 创建您的特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交您的更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建新的Pull Request

## 注意事项

- 游戏声音文件需要自行添加到`assets/sounds/`目录
- 游戏使用本地存储保存设置和高分，清除浏览器数据将丢失这些信息
- 在移动设备上，建议使用触屏控制模式