whale-town-front/docs/01-项目入门/项目设置指南.md

项目设置指南

本文档指导你完成WhaleTown项目的Godot编辑器配置，确保开发环境正确设置。

🎯 AutoLoad 配置

项目已经预配置了以下AutoLoad单例，你可以验证配置是否正确：

1. 打开项目设置

1. 在Godot编辑器中打开 Project → Project Settings
2. 切换到 AutoLoad 标签

2. 验证AutoLoad配置

确认以下单例已正确配置：

名称	路径	单例
GameManager	res://_Core/managers/GameManager.gd	✅
SceneManager	res://_Core/managers/SceneManager.gd	✅
EventSystem	res://_Core/systems/EventSystem.gd	✅
NetworkManager	res://_Core/managers/NetworkManager.gd	✅
ResponseHandler	res://_Core/managers/ResponseHandler.gd	✅

3. 如果需要手动添加AutoLoad

如果某个AutoLoad缺失，可以手动添加：

1. 点击 Add 按钮
2. 设置以下信息：
   • Path: 对应的脚本路径
   • Name: 单例名称
   • Singleton: ✅ 勾选
3. 点击 Add 确认

⚙️ 其他重要设置

主题配置

项目使用自定义中文主题：

• 路径: UI/Theme/MainTheme.tres
• 字体: 微软雅黑 (UI/Theme/Fonts/msyh.ttc)

主场景设置

• 主场景: res://Scenes/Maps/main_scene.tscn
• 窗口大小: 1376x768
• 窗口模式: 全屏模式

渲染设置

• 渲染器: GL Compatibility (兼容性优先)
• 拉伸模式: Canvas Items
• 拉伸比例: Expand

🧪 验证设置

1. 测试AutoLoad单例

在任何脚本中可以直接使用：

func _ready():
    # 测试GameManager
    print("游戏状态: ", GameManager.get_current_state())
    
    # 测试SceneManager
    print("当前场景: ", SceneManager.get_current_scene_name())
    
    # 测试EventSystem
    EventSystem.emit_event("test_event", {"message": "Hello World"})
    
    # 测试NetworkManager
    var request_id = NetworkManager.login("test_user", "test_password")
    print("网络请求ID: ", request_id)

2. 检查控制台输出

运行项目后，检查控制台是否有以下信息：

• ✅ 没有AutoLoad相关错误
• ✅ 各个管理器初始化成功
• ✅ 主题和字体加载正常

3. 测试场景切换

# 测试场景管理器
func test_scene_manager():
    # 切换到主场景
    SceneManager.change_scene("main")

🔧 常见问题排查

问题1: AutoLoad脚本找不到

症状: 控制台显示"Cannot load script"错误

解决方案:

1. 检查脚本文件是否存在于指定路径
2. 确认脚本文件没有语法错误
3. 重新导入项目 (Project → Reload Current Project)

问题2: 单例无法访问

症状: 代码中无法访问GameManager等单例

解决方案:

1. 确认AutoLoad配置中勾选了"Singleton"
2. 重启Godot编辑器
3. 检查脚本中是否有拼写错误

问题3: 主题显示异常

症状: 界面字体或样式显示不正确

解决方案:

1. 检查 UI/Theme/MainTheme.tres 文件是否存在
2. 确认字体文件 UI/Theme/Fonts/msyh.ttc 已正确导入
3. 在项目设置中重新设置自定义主题

问题4: 网络请求失败

症状: NetworkManager调用失败

解决方案:

1. 检查网络连接
2. 确认API地址配置正确
3. 查看ResponseHandler是否正常工作

📋 配置检查清单

完成设置后，请检查以下项目：

• 所有AutoLoad单例配置正确
• 主场景可以正常启动
• 控制台没有错误信息
• 自定义主题加载正常
• 中文字体显示正确
• 网络管理器可以正常调用
• 事件系统工作正常
• 场景管理器可以切换场景

🚀 下一步

配置完成后，建议继续阅读：

• 输入映射配置 - 设置游戏控制
• 命名规范 - 学习编码规范
• 架构与通信规范 - 理解项目架构

---

💡 提示: 如果遇到问题，可以参考 测试指南 进行更详细的功能验证。