企业官网建设流程全解析

1. 项目概述：从零到一，构建你的第一个Unity小游戏

如果你刚接触Unity，或者想找个简单有趣的项目练手，那“小球吃金币”绝对是个经典且完美的起点。这个项目麻雀虽小，五脏俱全，它几乎涵盖了游戏开发最核心的几个模块：玩家控制、物理交互、碰撞检测、分数系统和场景管理。我当年就是从类似的项目入门的，它能让你在短短一两个小时内，亲眼看到自己的代码如何驱动一个游戏世界运转起来，那种成就感是看再多教程都无法替代的。

简单来说，我们要做的就是：创建一个3D场景，用一个由玩家控制的小球，在平台上滚动，去触碰（“吃”）散落各处的金币，每吃到一个金币，屏幕上的分数就增加，当吃完全部金币，游戏胜利。听起来很简单，对吧？但在这个过程中，你会亲手实践如何导入资源、编写控制脚本、处理物理碰撞、设计UI界面，甚至可能接触到简单的游戏状态管理。这不仅是学习Unity引擎操作，更是在理解一个游戏最基本的运行逻辑。无论你是编程新手，还是有一定基础想熟悉Unity工作流的开发者，这个项目都能给你带来扎实的收获。

2. 核心模块设计与思路拆解

在动手写代码和摆场景之前，我们先花几分钟把整个游戏的骨架搭起来。一个好的设计思路能让你在开发过程中少走很多弯路，避免写到一半发现架构有问题要推倒重来。

2.1 游戏对象与组件规划

Unity采用的是基于组件的实体架构，我们的游戏世界由一个个“GameObject”（游戏对象）构成，而功能则通过为这些对象添加“Component”（组件）来实现。对于这个项目，我们需要规划几个核心对象：

1. 玩家小球 (Player Ball)：这是游戏的主角。它需要一个球体碰撞器来定义物理边界，一个刚体组件来接受物理引擎的驱动（比如重力、碰撞反馈），以及一个我们自定义的脚本组件来处理玩家的输入，控制小球移动。
2. 金币 (Coin)：这是玩家收集的目标。它通常是一个简单的模型（比如一个圆柱体加一个圆片），需要一个碰撞器（为了被检测到），以及一个脚本，当被小球碰撞时，触发“被收集”的事件——比如播放一个旋转动画、音效，然后销毁自身，并通知游戏管理器加分。
3. 游戏平台/地面 (Ground)：这是一个大的平面或立方体，作为小球滚动的舞台。它需要一个碰撞器，但通常不需要刚体（除非你想要一个会动的地面），它的作用是让小球和金币不会掉出世界。
4. 游戏管理器 (GameManager)：这是一个“幕后黑手”式的空对象。它不直接显示在场景里，但挂载着管理游戏全局状态的脚本。比如，它负责记录当前分数、判断是否所有金币都被收集（游戏胜利）、控制UI界面的更新（显示分数、胜利文本）等。使用单例模式来设计这个管理器会非常方便，确保在游戏的任何地方都能访问到它。
5. UI界面 (Canvas)：包括显示分数的Text组件，以及可能有的“游戏胜利”提示面板。

这个规划的核心思想是“职责分离”。小球只负责移动和碰撞，金币只负责被收集时销毁自己并发出信号，管理器负责统筹全局数据和逻辑。这样代码结构清晰，后期如果想增加新功能（比如敌人、陷阱），也更容易扩展。

2.2 物理与输入系统选型

Unity内置了强大的物理引擎（NVIDIA PhysX）和输入管理系统，我们需要决定如何利用它们。

对于物理系统，我们肯定要使用刚体物理。这意味着小球和金币的移动、旋转、碰撞都将由物理引擎模拟，效果真实且省力。为小球添加Rigidbody组件后，它会自动受到重力下落。我们的控制脚本不是直接修改它的位置，而是通过给刚体施加力或直接设置速度来驱动它，这样碰撞反馈才会正确。

对于输入控制，Unity的新输入系统（Input System Package）功能强大且支持跨平台，但对于这个超小型项目，使用传统的Input.GetAxis方法更加快捷直观。我们可以通过读取键盘的“Horizontal”（A/D或左右箭头）和“Vertical”（W/S或上下箭头）输入，来构建一个控制小球滚动的力或速度向量。

这里有一个关键考量：控制方式。是采用力模式还是速度模式？

• 力模式 (AddForce)：模拟真实的推力，小球会有加速和减速的过程，手感更真实，但控制起来需要更精细，惯性可能让新手觉得“滑”。
• 速度模式 (直接设置velocity)：直接指定小球每帧的速度，控制响应即时，手感更“跟手”，适合需要精确操控的街机风格。

对于入门项目，我推荐先从速度模式开始，因为它更简单直接，能让你快速获得正反馈。等熟悉了再尝试力模式，体验不同的手感差异。

3. 场景搭建与资源准备

思路清晰后，我们就可以打开Unity Hub，创建一个新的3D项目，开始动手搭建我们的游戏世界了。

3.1 基础场景构建

创建项目后，你首先会看到一个默认场景，里面有一个主摄像机和一个平行光。我们第一步是清理和规划场景层级。

1. 创建地面：在层级视图右键 -> 3D Object -> Plane，重命名为“Ground”。调整它的缩放（Scale），比如设为 (10, 1, 10)，让它成为一个足够大的平台。默认的Plane自带了Mesh Collider，这就可以了。你可以给它一个材质，改变颜色，比如深灰色，让它看起来像水泥地。
2. 创建玩家小球：右键 -> 3D Object -> Sphere，重命名为“Player”。将它放置在Ground上方一点的位置，比如设置Position的Y坐标为1，这样它生成后会落在平台上，而不是嵌进去。调整它的缩放，比如(0.5, 0.5, 0.5)，让它大小合适。
3. 设置玩家物理属性：选中Player对象，在检查器（Inspector）中点击“Add Component”，搜索并添加Rigidbody组件。你会看到质量（Mass）、阻力（Drag）等参数。暂时保持默认即可。为了获得更好的滚动效果，我们可以稍微增加一些角阻力（Angular Drag），比如设为0.5，这样小球旋转停下来会快一点，手感更稳。
4. 创建金币：金币我们可以用一个组合体来简单模拟。先创建一个圆柱体（Cylinder），重命名为“Coin”。调整其缩放，比如(1, 0.1, 1)，让它变成一个扁平的圆盘。为了好看，可以再创建一个Cube，缩放成(1.5, 0.05, 0.1)，作为金币中间的“横杠”，将它作为Coin的子对象。然后，为Coin对象添加一个Rigidbody组件，但勾选Is Kinematic。Kinematic刚体不受物理力影响，但可以参与碰撞检测。我们不需要金币自己乱滚，只需要它被碰时能检测到，所以这样设置最合适。最后，别忘了添加一个碰撞器，圆柱体自带的Capsule Collider就可以。

现在，你的场景里应该有一个平台，上面站着一个小球，旁边可能有一个金币。基础的物理世界已经就位了。

3.2 材质与光照简单美化

虽然我们是做玩法原型，但一点简单的美化能极大提升开发时的愉悦感。Unity的材质系统非常直观。

1. 创建材质：在项目窗口右键 -> Create -> Material，命名为“BallMat”。选中它，在检查器里，将Albedo（漫反射颜色）调成你喜欢的颜色，比如亮红色。用同样的方法创建“GroundMat”（灰色）和“CoinMat”（金色）。调整CoinMat的Metallic（金属度）滑块到0.8，Smoothness（光滑度）到0.6，它看起来就更像金属了。
2. 应用材质：直接将创建好的材质球从项目窗口拖拽到场景中对应的游戏对象上，对象的外观就会立即改变。
3. 调整光照：默认的平行光可能太强或角度不好。选中Directional Light，可以调整它的旋转（Rotation）来改变阴影方向，调整强度（Intensity）来改变亮度。一个从斜上方45度打下来的光通常能提供不错的立体感。你还可以在Window -> Rendering -> Lighting设置中，点击“Generate Lighting”，让Unity烘焙一下光照，这样静态物体的光影效果会更实，运行时光照开销也更小。

注意：在项目初期，不要过度追求美术效果。我们的核心是功能和逻辑。这些美化步骤是为了让测试时不至于太“辣眼睛”，但重心一定要放在代码实现上。很多新手容易在这里陷入不断调整材质和灯光的循环，耽误了主要进度。

4. 核心脚本编写与功能实现

游戏场景是舞台，脚本才是让舞台活起来的灵魂。接下来我们编写三个核心脚本。

4.1 玩家控制脚本 (PlayerController.cs)

这个脚本挂载在Player小球上，负责读取玩家输入并控制小球运动。

using UnityEngine; public class PlayerController : MonoBehaviour { // 移动速度，可以在Unity编辑器里调整 public float moveSpeed = 10f; // 引用小球的刚体组件 private Rigidbody rb; void Start() { // 在游戏开始时，获取挂载在同一对象上的Rigidbody组件 rb = GetComponent<Rigidbody>(); if (rb == null) { Debug.LogError("PlayerController: 未找到Rigidbody组件！"); } } void FixedUpdate() { // FixedUpdate在固定的物理时间步长调用，更适合处理物理相关的操作 HandleMovement(); } void HandleMovement() { // 1. 获取原始输入值（-1 到 1之间） float moveHorizontal = Input.GetAxis("Horizontal"); // A/D, 左右箭头 float moveVertical = Input.GetAxis("Vertical"); // W/S, 上下箭头 // 2. 基于摄像机的方向，构建一个正确的移动向量。 // 假设摄像机是从上往下看的俯视角，或者稍微有点倾斜。 // 这里我们使用最简单的方式：将输入直接映射到X和Z轴（水平地面）。 Vector3 movement = new Vector3(moveHorizontal, 0.0f, moveVertical); // 3. 将向量标准化并乘以速度，得到最终的速度向量。 // 标准化是为了防止斜向移动时速度更快（勾股定理）。 if (movement.magnitude > 1) { movement.Normalize(); } Vector3 targetVelocity = movement * moveSpeed; // 4. 应用速度。这里我们直接设置速度，实现即时响应的手感。 // 另一种方式是使用 AddForce，手感更真实但惯性大。 rb.velocity = new Vector3(targetVelocity.x, rb.velocity.y, targetVelocity.z); // （可选）让小球朝向移动方向旋转，视觉效果更好 if (movement != Vector3.zero) { transform.forward = Vector3.Slerp(transform.forward, movement, Time.deltaTime * 10f); } } }

代码解析与实操要点：

• FixedUpdatevsUpdate: 所有涉及物理引擎操作（如修改Rigidbody的速度、位置、施加力）的代码，都应该放在FixedUpdate中。因为物理引擎的更新是固定频率的（默认0.02秒一次），与帧率无关。放在Update里会导致物理行为不稳定。
• GetComponent(): 这是一个非常常用的方法，用于获取同一游戏对象上挂载的其他组件。我们在Start中获取并缓存Rigidbody的引用，比在每次FixedUpdate中都去获取要高效。
• 速度控制：我们直接设置了rb.velocity。velocity是一个Vector3，代表刚体每秒钟在世界空间中的移动单位数。我们保留了Y轴原有的速度（主要是重力下落的速度），只修改X和Z轴，这样小球才能在斜坡上自然滚动。
• 输入映射：Input.GetAxis(“Horizontal”)返回一个平滑的值。你也可以使用Input.GetAxisRaw，它返回-1，0，1三个整数，没有平滑过渡，手感更“硬”。

将脚本拖到Player对象上，运行游戏，你现在应该可以用WASD或方向键控制小球在平台上滚动了！

4.2 金币脚本 (Coin.cs)

这个脚本挂载在每个金币预制体上，负责处理被收集的逻辑。

using UnityEngine; public class Coin : MonoBehaviour { // 旋转速度，让金币看起来在自转 public float rotateSpeed = 100f; void Update() { // 每帧绕Y轴旋转，产生动态效果 transform.Rotate(0, rotateSpeed * Time.deltaTime, 0); } // 当有其他碰撞体进入触发器时调用 void OnTriggerEnter(Collider other) { // 检查碰撞对象是否是玩家（通过标签判断） if (other.CompareTag("Player")) { CollectCoin(); } } void CollectCoin() { // 通知游戏管理器增加分数 GameManager.Instance.AddScore(1); // 这里可以播放收集音效（需要AudioSource组件） // AudioSource.PlayClipAtPoint(collectSound, transform.position); // 销毁金币对象 Destroy(gameObject); } }

代码解析与实操要点：

• 旋转动画：在Update中让金币持续旋转，这是一个简单的视觉反馈，让金币看起来更吸引人。Time.deltaTime确保了旋转速度与帧率无关，在任何机器上都是一致的。
• 碰撞检测：我们使用了OnTriggerEnter而不是OnCollisionEnter。这两者的区别在于碰撞器（Collider）的设置。OnCollisionEnter需要两个物体都有非触发器的碰撞器且至少一个刚体，模拟真实的物理碰撞（会弹开）。OnTriggerEnter则需要至少一个物体的碰撞器勾选了Is Trigger选项，它只检测重叠，不产生物理阻挡。对于金币这种被“吃掉”的物品，用触发器更合适。
  • 操作：选中场景中的Coin对象，在检查器中找到它的Capsule Collider组件，勾选Is Trigger。
• 标签（Tag）的使用：我们通过other.CompareTag(“Player”)来判断碰撞对象是不是玩家。这是一种高效且清晰的方式。你需要提前给Player对象设置Tag。
  • 操作：在Unity编辑器顶部的菜单栏，点击Edit -> Project Settings -> Tags and Layers。在Tags列表的空白处，添加一个名为“Player”的标签。然后选中场景中的Player对象，在检查器顶部的Tag下拉框中，选择“Player”。
• 与管理器通信：金币被收集后，需要通知游戏管理器加分。这里我们通过一个单例GameManager.Instance来访问。这是一种常用的跨对象通信模式。

4.3 游戏管理器脚本 (GameManager.cs)

这是游戏的大脑，管理全局状态和UI。

using UnityEngine; using UnityEngine.UI; // 引入UI命名空间 public class GameManager : MonoBehaviour { // 单例实例，方便其他脚本访问 public static GameManager Instance { get; private set; } // UI文本组件，用于显示分数 public Text scoreText; // 胜利提示面板 public GameObject winPanel; // 场景中总共的金币数量（用于判断胜利） private int totalCoins; // 当前分数 private int currentScore = 0; void Awake() { // 实现单例模式 if (Instance != null && Instance != this) { Destroy(this.gameObject); } else { Instance = this; } } void Start() { // 游戏开始时，查找场景中所有Coin对象，计算总数 totalCoins = GameObject.FindGameObjectsWithTag("Coin").Length; // 初始化UI显示 UpdateScoreText(); // 确保胜利面板开始时是隐藏的 if (winPanel != null) { winPanel.SetActive(false); } } // 增加分数的方法，由Coin脚本调用 public void AddScore(int points) { currentScore += points; UpdateScoreText(); CheckWinCondition(); } // 更新UI上的分数显示 void UpdateScoreText() { if (scoreText != null) { scoreText.text = "Score: " + currentScore.ToString(); } } // 检查是否收集了所有金币 void CheckWinCondition() { if (currentScore >= totalCoins) { WinGame(); } } // 游戏胜利的逻辑 void WinGame() { Debug.Log("恭喜！你收集了所有金币！"); // 显示胜利UI if (winPanel != null) { winPanel.SetActive(true); } // 这里可以暂停游戏、播放胜利音乐等 // Time.timeScale = 0f; } }

代码解析与实操要点：

• 单例模式 (Singleton)：public static GameManager Instance { get; private set; }这行代码创建了一个静态属性，使得在游戏的任何脚本中，都可以通过GameManager.Instance来访问这个唯一的游戏管理器。Awake方法中的逻辑确保了场景中只会存在一个GameManager实例。
• 查找游戏对象：GameObject.FindGameObjectsWithTag(“Coin”)在游戏开始时运行，查找所有带有“Coin”标签的对象，并统计数量。这意味着你需要在创建每个金币预制体时，都为其设置“Coin”标签。这种方式比手动在编辑器里设置totalCoins变量更灵活，你增减金币数量时，代码会自动适应。
• UI系统集成：我们使用了Unity的UGUI系统。你需要先在场景中创建UI。
  • 操作：在层级视图右键 -> UI -> Canvas。这会创建一个画布和EventSystem。然后在Canvas下右键 -> UI -> Text，创建一个Text对象，重命名为“ScoreText”。调整它的位置（比如左上角）、字体大小和颜色。
  • 关联：将场景中的ScoreText对象拖拽到GameManager脚本的scoreText公共变量槽中。
  • 胜利面板：同样，在Canvas下创建一个Panel，重命名为“WinPanel”，在里面放一个Text写着“You Win!”。在GameManager脚本中，将这个WinPanel对象拖拽到winPanel变量槽中。

5. 预制体制作与场景布置

当我们的金币脚本写好并挂载到一个金币上后，这个金币就已经是一个功能完整的可收集物了。但场景中需要很多个金币，我们不可能一个个手动设置旋转、碰撞器和标签。这时就需要用到“预制体”。

5.1 创建金币预制体

1. 在场景中，确保你的那个样板Coin对象已经设置好：模型正确、材质金色、Capsule Collider勾选了Is Trigger、挂载了Coin.cs脚本且rotateSpeed设置合理（比如100），并且它的Tag是“Coin”。
2. 在项目窗口，找到一个合适的文件夹（比如“Prefabs”），右键 -> Create -> Folder，命名为“Prefabs”。
3. 将场景中的这个Coin对象，直接从层级视图拖拽到项目窗口的“Prefabs”文件夹里。你会看到它变成了一个蓝色的立方体图标，这就是预制体。
4. 此时，场景中的这个对象名字会变成蓝色，表示它是预制体的一个实例。

预制体的好处：现在，你可以从项目窗口把这个Coin预制体拖到场景中任意位置，创建无数个副本。所有副本都自动拥有完全相同的组件、属性和脚本。如果你想修改所有金币的旋转速度，只需要在项目窗口双击打开预制体进行编辑，或者直接修改预制体资源，所有场景中的实例都会同步更新（除非你单独覆盖了某个实例的属性）。

5.2 高效布置场景

有了预制体，布置关卡就快多了。

1. 从项目窗口，将Coin预制体多次拖入场景，分散放置在Ground平台的各个位置。你可以利用Unity的移动（W）、旋转（E）、缩放（R）工具进行微调，让布局看起来自然有趣，有些放在平地，有些可以放在小坡上（需要你创建一些斜坡物体）。
2. 为了增加挑战性，可以创建一些障碍物。比如在层级视图右键 -> 3D Object -> Cube，重命名为“Obstacle”，缩放成各种形状，摆放在平台上。为它们添加碰撞器（Cube自带Box Collider），但不要添加刚体（除非你想要可移动的障碍）。这样小球撞上去就会被挡住。
3. 布置完成后，再次运行游戏。GameManager的Start方法会自动统计场景中所有Tag为“Coin”的对象数量作为totalCoins。控制小球去吃金币吧！每吃一个，左上角的分数应该会增加，吃完所有金币后，“You Win!”面板应该会弹出。

6. 功能扩展与优化思路

基础功能完成后，这个项目就有了无穷的扩展可能。这里分享几个经典的扩展方向，你可以选择一两个来实践，能极大提升你的Unity技能。

6.1 增加音效与粒子特效

游戏离不开视听反馈。收集金币时的一个清脆音效和一个小型爆炸粒子，能让体验提升好几个档次。

1. 音效：

   • 准备一个“.wav”或“.mp3”格式的音效文件，导入Unity。
   • 在Coin预制体上，添加一个AudioSource组件。取消勾选Play On Awake。
   • 在Coin.cs脚本中，增加一个公共变量：public AudioClip collectSound;。
   • 在Unity编辑器里，将导入的音效文件拖到Coin预制体上Coin脚本的collectSound变量槽中。
   • 修改CollectCoin方法，在Destroy之前添加播放音效的代码：

     // 方法一：使用自带的AudioSource播放（如果音效短，且不需要3D效果） // GetComponent<AudioSource>().PlayOneShot(collectSound); // 方法二：在当前位置创建一个临时的音频源播放（更常用，尤其适合3D音效） AudioSource.PlayClipAtPoint(collectSound, transform.position); Destroy(gameObject, 0.1f); // 延迟0.1秒销毁，确保音效能播出来

2. 粒子特效：

   • 在项目窗口右键 -> Effects -> Particle System，创建一个粒子系统，重命名为“CoinCollectEffect”。
   • 选中它，在检查器里调整参数：将Duration（持续时间）调短（如0.5秒），取消勾选Looping（不循环）。在Emission模块将Rate over Time调为0，在Bursts里添加一个爆发，粒子数设为10-20。在Shape模块将形状设为Sphere。调整Start Color为金色到黄色的渐变，Start Size调小一些。
   • 将这个调好的粒子系统对象也做成一个预制体。
   • 在Coin.cs脚本中，增加一个公共变量：public GameObject collectEffectPrefab;，并将粒子预制体拖拽赋值。
   • 在CollectCoin方法中，在销毁金币前实例化这个粒子效果：

     if (collectEffectPrefab != null) { Instantiate(collectEffectPrefab, transform.position, Quaternion.identity); }

6.2 实现关卡计时与难度递增

增加时间限制和动态难度是让游戏变得“可玩”的关键。

1. 计时器：在GameManager.cs中增加计时逻辑。

   public float timeLimit = 60f; // 关卡时间限制，秒 private float currentTime; public Text timeText; // 用于显示时间的UI Text void Start() { currentTime = timeLimit; UpdateTimeText(); } void Update() { if (currentTime > 0) { currentTime -= Time.deltaTime; UpdateTimeText(); if (currentTime <= 0) { currentTime = 0; GameOver(); // 时间到，游戏结束 } } } void UpdateTimeText() { if (timeText != null) { timeText.text = "Time: " + Mathf.Ceil(currentTime).ToString(); } } void GameOver() { // 显示游戏结束UI，停止玩家控制等 Debug.Log("时间到！游戏结束。"); }

2. 动态难度：你可以让金币旋转速度随时间加快，或者每隔一段时间在随机位置生成一个新的障碍物。这需要在GameManager里用协程（Coroutine）或InvokeRepeating来实现。例如，在Start方法中启动一个协程，每10秒执行一次IncreaseDifficulty函数，该函数可以查找所有金币并增加它们的rotateSpeed。

6.3 构建简单关卡与场景切换

一个完整的游戏通常有多个关卡。我们可以为每个关卡创建一个独立的Unity场景。

1. 保存当前场景：File -> Save As，将你的第一个关卡保存为“Level1”。
2. 创建新场景：File -> New Scene，然后搭建一个新的平台，用不同的布局摆放金币和障碍物，保存为“Level2”。
3. 场景切换逻辑：在GameManager的WinGame方法中，当玩家获胜后，可以等待几秒，然后加载下一关。

   public string nextLevelName; // 在编辑器里填入下一关的场景名，如"Level2" void WinGame() { // ... 显示胜利UI ... Invoke("LoadNextLevel", 2f); // 2秒后加载下一关 } void LoadNextLevel() { if (!string.IsNullOrEmpty(nextLevelName)) { UnityEngine.SceneManagement.SceneManager.LoadScene(nextLevelName); } else { Debug.Log("已是最后一关！"); } }

4. 场景管理：你需要确保游戏管理器在关卡切换时不被销毁，以便保持分数等数据。这可以通过DontDestroyOnLoad实现，但更常见的做法是每个关卡都有自己的GameManager，或者使用一个独立的、常驻的“持久化”对象来存储需要跨关卡的数据。

7. 常见问题与调试技巧实录

开发过程中，你几乎一定会遇到下面这些问题。别担心，这都是学习的一部分。

7.1 小球控制手感“太滑”或“不跟手”

• 问题描述：小球像在冰面上一样停不下来，或者响应输入有延迟。
• 排查与解决：
  1. 检查刚体参数：选中Player小球，查看Rigidbody组件。增加Drag（阻力）和Angular Drag（角阻力）可以有效地让小球更快停下来。Drag影响直线运动，Angular Drag影响旋转。尝试将Drag设为1-3，Angular Drag设为0.5-1。
  2. 检查控制脚本：确认你是在FixedUpdate中修改速度或施加力。在Update中做这些事会导致物理更新不稳定。
  3. 尝试不同的控制方式：如果你用的是rb.velocity，可以试试AddForce。AddForce需要调整力的大小（force参数）和力的模式（ForceMode）。ForceMode.Force是持续的力，ForceMode.Impulse是瞬间的冲量。通常用ForceMode.Force并配合一个适中的力值（如500），手感会更模拟真实。
  4. 限制最大速度：有时小球会因为持续受力而越来越快。可以在FixedUpdate中限制刚体的水平速度。

     Vector3 horizontalVel = new Vector3(rb.velocity.x, 0, rb.velocity.z); if (horizontalVel.magnitude > maxSpeed) { horizontalVel = horizontalVel.normalized * maxSpeed; rb.velocity = new Vector3(horizontalVel.x, rb.velocity.y, horizontalVel.z); }

7.2 金币碰撞检测失败

• 问题描述：小球穿过了金币，但没有触发加分和销毁。
• 排查与解决：
  1. 确认触发器：确保金币的碰撞器组件上，Is Trigger选项被勾选。这是OnTriggerEnter生效的前提。
  2. 确认标签：确保Player对象的Tag是“Player”，并且Coin脚本里OnTriggerEnter方法中判断的标签字符串拼写完全一致（区分大小写）。
  3. 确认刚体：参与触发器检测的两个物体，至少有一个需要有刚体。我们的Player有刚体，这没问题。金币的刚体勾选了Is Kinematic，这也符合要求。
  4. 使用Debug.Log调试：在OnTriggerEnter方法开头添加Debug.Log(“触发了: ” + other.name);。运行游戏，让小球去碰金币，看看控制台有没有输出。如果有输出但没执行CollectCoin，说明标签判断没通过；如果根本没输出，说明触发器没生效，回头检查1和3。

7.3 游戏管理器单例报空引用（NullReferenceException）

• 问题描述：运行游戏时，控制台报错“NullReferenceException: Object reference not set to an instance of an object”，指向GameManager.Instance。
• 排查与解决：
  1. 场景中是否有GameManager对象：这是最常见的原因。你必须在场景中创建一个空游戏对象（右键 -> Create Empty），重命名为“GameManager”，然后将GameManager.cs脚本挂载上去。
  2. 脚本执行顺序：Awake方法在所有Start方法之前调用。确保你的GameManager对象在场景加载时就存在。如果它是动态实例化的，需要在实例化后立刻初始化单例。
  3. 多个GameManager实例：如果你的场景中不小心放了多个带有GameManager脚本的对象，Awake里的销毁逻辑可能会把“正确”的那个也销毁掉。检查层级视图，确保只有一个。

7.4 UI文本不更新或找不到

• 问题描述：分数文本一直是0，或者控制台报错找不到scoreText。
• 排查与解决：
  1. 公共变量赋值：在Unity编辑器中，选中GameManager对象，在检查器里找到GameManager (Script)组件。你会看到Score Text和Win Panel两个变量槽是空的。你必须把场景中对应的UI对象（ScoreText和WinPanel）分别拖拽到这两个槽里完成赋值。这是新手最容易忘记的一步。
  2. Canvas渲染模式：确保你的Canvas的渲染模式是“Screen Space - Overlay”或“Screen Space - Camera”并正确指定了摄像机。如果是“World Space”，UI可能会出现在奇怪的位置甚至看不到。
  3. Text组件引用：确认你拖拽给scoreText的对象，上面确实有Text组件。有时不小心拖成了它的父对象Panel。

这个项目虽然基础，但它像一颗种子，包含了游戏开发最核心的基因。当你成功实现它之后，那些看似复杂的游戏机制——比如角色技能、敌人AI、任务系统、存档读档——你会发现，它们都是在这个基础框架上，通过增加更多的对象、更复杂的脚本和更精巧的交互搭建起来的。我建议你在完成基础版本后，一定要尝试至少一个扩展功能，比如加上音效和粒子，或者做一个计时挑战模式。这个过程里遇到的每一个错误和解决的每一个问题，都会让你对Unity引擎的理解加深一分。