# 📖 项目入门

> **适用人群**: 新加入项目的开发者  
> **使用时机**: 项目开始前，环境搭建阶段

这个目录包含了新人入门必读的基础文档，帮助你快速了解项目并搭建开发环境。

## 📋 阅读顺序

### 第一步：了解项目 🏗️
**[项目结构说明.md](项目结构说明.md)**
- 项目整体架构设计
- 目录组织规则
- 各层级职责说明
- 团队协作方式

### 第二步：配置环境 ⚙️
**[项目设置指南.md](项目设置指南.md)**
- Godot编辑器配置
- AutoLoad单例设置
- 开发环境验证

### 第三步：设置控制 🎮 **[必需]**
**[输入映射配置.md](输入映射配置.md)**
- 游戏输入控制配置
- 键盘和手柄映射
- 输入系统测试

⚠️ **重要提醒**: 输入映射配置是必需的！项目代码中使用了 `move_left`、`move_right`、`move_up`、`move_down`、`interact`、`pause` 等输入动作，必须在Godot编辑器中正确配置，否则游戏无法正常运行。

## ✅ 完成检查

阅读完本目录的文档后，你应该能够：
- [ ] 理解项目的整体架构
- [ ] 成功配置Godot开发环境
- [ ] **正确设置游戏输入映射** ⚠️ 必需
- [ ] 运行项目并进行基本测试
- [ ] 验证所有AutoLoad单例正常工作

## 🚨 常见启动问题

### 问题1: 游戏无法响应输入
**原因**: 输入映射未配置  
**解决**: 必须完成 [输入映射配置.md](输入映射配置.md) 中的所有步骤

### 问题2: 控制台出现"Invalid action"错误
**原因**: 缺少必需的输入动作  
**解决**: 确保配置了以下6个输入动作：
- `move_left`, `move_right`, `move_up`, `move_down`
- `interact`, `pause`

### 问题3: AutoLoad单例报错
**原因**: AutoLoad配置不正确  
**解决**: 参考 [项目设置指南.md](项目设置指南.md) 验证配置

## 🔗 下一步

完成项目入门后，建议继续阅读：
- [02-开发规范](../02-开发规范/) - 学习编码标准
- [03-技术实现](../03-技术实现/) - 开始具体开发

## 💡 小贴士

- **输入映射是第一优先级** - 不配置输入映射，游戏无法正常运行
- 遇到问题时，先查看对应文档的"常见问题"部分
- 建议在实际操作中边读边做，加深理解
- 可以将重要的配置信息做笔记备用
- 完成每个步骤后，建议运行项目验证配置是否正确