1. 项目概述：为什么选择“跳一跳”作为Unity入门项目？

如果你刚接触Unity，或者想找一个能串联起物理、动画、UI和简单逻辑的完整小项目来练手，那“跳一跳”这个经典玩法绝对是个宝藏。它规则简单到一句话就能说清：按住屏幕蓄力，松开让角色跳跃到下一个平台，根据跳跃距离精准度得分。但正是这份简单，让它成为了检验游戏开发基本功的绝佳试金石。我当年带新人，第一个实战案例基本就是它，因为它能逼着你把Unity那些核心模块——从刚体物理、动画状态机到UI交互和场景管理——全都实实在在地用一遍，而不是停留在看教程的层面。

市面上很多“入门教程”做完一个打砖块或者跑酷就结束了，总觉得缺了点什么。“跳一跳”则不同，它要求你处理“蓄力与释放”的精确输入，计算抛物线轨迹，动态生成看似随机实则可控的平台，还要有一套清晰的分数和连击反馈。整个过程下来，你对GameObject、Component、Prefab（预制体）这些核心概念的理解会深刻得多。更重要的是，它的扩展性极强，做完基础版，你完全可以自己加道具、加皮肤、加关卡，甚至改成多人对战，乐趣无穷。最关键的是，我们这次从零开始，用的所有资源和工具都是免费的，确保你能无门槛地跟着做下来。

2. 核心思路与架构设计：拆解“跳一跳”的骨架

在动手写代码之前，我们先得把游戏拆解成几个可以独立实现、再组合起来的模块。用盖房子的思路来想，你得先有图纸。对于“跳一跳”，我们可以把它分解为以下四个核心层：

2.1 场景与对象层：游戏里都有哪些“演员”？

这是最直观的一层。在Unity的Hierarchy视图里，你会创建这些主要对象：

• 玩家角色 (Player)：通常是一个胶囊体(Capsule)或者一个方块，上面挂着控制脚本和刚体(Rigidbody)组件，让它能受物理引擎影响进行跳跃。
• 平台 (Platform)：游戏的核心交互对象。我们需要两种平台：一种是固定的“起跳平台”，另一种是后续动态生成的“目标平台”。平台本身可以是一个Cube，为了美观可以贴上不同的材质。
• 摄像机 (Main Camera)：跟随玩家角色移动，确保角色始终在画面中央偏下的位置，为跳跃预留视野空间。
• UI画布 (Canvas)：显示当前分数、历史最高分、蓄力指示器（比如一个逐渐拉长的箭头或能量条）和游戏结束界面。

2.2 逻辑控制层：游戏运行的“大脑”

这一层由C#脚本驱动，是游戏的核心。主要包含以下几个脚本：

• PlayerController.cs：附着在玩家角色上。它负责：
  • 监听玩家的输入（鼠标按下/抬起，或触摸屏的触摸事件）。
  • 根据按下的时长计算蓄力大小。
  • 在按下时，可能还需要控制一个蓄力指示器（如一个Scale在Y轴变大的箭头Sprite）的显示。
  • 在松开时，根据蓄力值，给角色刚体施加一个力，实现跳跃。
• PlatformSpawner.cs：通常附着在一个空物体上，比如叫“GameManager”。它负责：
  • 管理平台的生成逻辑。游戏开始时生成第一个平台和玩家，之后每当玩家成功落在一个平台上，就在前方某个随机位置生成下一个新平台。
  • 控制平台的生成范围，比如X轴和Z轴的随机偏移，确保游戏既有挑战性又不会 impossible。
• GameManager.cs：游戏的中央管理器。它负责：
  • 管理游戏状态（开始、进行中、结束）。
  • 计算和更新分数。跳得越准（落在平台中心），得分越高，甚至可能有“精准中心”的额外加分和连击效果。
  • 处理游戏结束逻辑（角色掉落），并弹出重新开始界面。

2.3 物理与运动层：让跳跃“真实”起来

Unity内置的物理引擎（NVIDIA PhysX）是我们的好帮手。我们不需要自己写复杂的抛物线公式，只需要：

• 为玩家角色添加Rigidbody组件。这样它就会受到重力影响。
• 在PlayerController脚本中，通过Rigidbody.AddForce()方法，施加一个向上的力（ForceMode.Impulse瞬间冲量模式很合适）。跳跃的距离和高度就由这个力的大小和方向决定。
• 通过Physics.Raycast（射线检测）来判断角色是否稳稳地站在了平台上，这是触发得分和生成新平台的关键条件。

2.4 表现与反馈层：让游戏“好看”又好懂

游戏不是冷冰冰的模拟，需要给玩家即时的反馈：

• 动画：角色跳跃时可以有一个简单的缩放或旋转动画。更高级一点，可以做一个“蓄力颤抖”的动画。
• 粒子效果：角色起跳时脚下可以有一个灰尘粒子，落在平台中心时爆出一个星星粒子效果。
• UI反馈：分数变化时不是简单地改数字，可以做一个放大再缩小的动画。蓄力条要有平滑的填充效果。连击时屏幕边缘可以闪一下特效。
• 音效：跳跃声、落地声、得分声、打破记录声，这些短小的音效能极大提升游戏体验。

3. 从零开始：搭建开发环境与创建基础场景

工欲善其事，必先利其器。我们首先需要一个干净、可用的Unity开发环境。

3.1 Unity编辑器的安装与项目初始化

1. 下载Unity Hub：这是管理不同Unity版本和项目的官方工具。访问Unity官网，下载对应你操作系统的Unity Hub。
2. 安装Unity编辑器：在Hub的“安装”页面，添加一个Unity版本。对于这个2D/3D混合的小游戏，我推荐使用Unity 2021.3 LTS或2022.3 LTS版本。LTS（长期支持版）稳定，社区资源丰富，踩坑少。安装时，在模块选择页面，确保勾选了“Windows Build Support”或“macOS Build Support”（根据你的系统）以及“Android Build Support”（如果你想后续发布到手机）。其他的如iOS、WebGL等按需选择。
3. 创建新项目：打开Hub，点击“新建项目”。模板选择“3D (Core)”。虽然“跳一跳”视角像是2D，但它的跳跃有纵深（Z轴），用3D模板更灵活。给项目起个名字，比如“MyJumpJump”，选择好存储路径，点击创建。

注意：如果Unity编辑器启动后出现黑屏或无响应（对应热词中的“unity程序打开黑屏无响应”），这通常与显卡驱动有关。尝试更新显卡驱动到最新版本，或者在Unity Hub编辑器的“设置”->“许可证”中，切换为“个人版”许可证。如果问题依旧，可以尝试以管理员身份运行Unity。

3.2 构建基础游戏场景

项目打开后，你会看到默认的3D场景里有一个主摄像机和一个方向光。我们开始搭建基础场景：

1. 创建地面和玩家：
   • 在Hierarchy面板右键 -> 3D Object -> Plane，重命名为“Ground”。这作为初始的地面。你可以调整它的Scale，比如放大到(10,1,10)。
   • 再次右键 -> 3D Object -> Capsule，重命名为“Player”。这就是我们的主角。将它放置在Ground上方，比如Position设为(0, 1, 0)。
2. 设置摄像机：
   • 选中Main Camera，调整它的Transform。一个经典的“跳一跳”视角是侧上方45度角俯视。你可以尝试设置Position为(0, 10, -10)，Rotation为(45, 0, 0)。这样既能看清角色，又能看到前方的平台。
   • 为了让摄像机跟随玩家，我们稍后会写脚本。暂时先这样。
3. 创建第一个平台：
   • 右键 -> 3D Object -> Cube，重命名为“StartPlatform”。把它放在Player脚下，作为起跳点。调整它的Scale，比如(3, 0.5, 1)，让它变成一个长条状。
   • 为了美观，我们可以给它加个颜色。在Project面板右键 -> Create -> Material，命名为“PlatformMat”。选中它，在Inspector面板，将Albedo颜色调成你喜欢的（比如绿色）。然后将这个材质球拖到StartPlatform上。
4. 添加物理组件：
   • 选中Player，点击Inspector底部的“Add Component”，搜索并添加“Rigidbody”组件。这个组件会让物体受物理引擎控制。保持默认设置即可，但可以稍微调大“Mass”（质量）到2，让跳跃手感更沉稳。
   • 选中StartPlatform和Ground，同样添加Rigidbody组件。但关键的一步：勾选Rigidbody组件上的“Is Kinematic”（是运动学物体）。这意味着它们不受物理力影响（不会被撞飞），但可以与其他刚体发生碰撞。同时，为了性能，也可以勾选“Freeze Rotation”冻结所有旋转，防止它们意外翻倒。

4. 核心功能实现：编写玩家控制与跳跃逻辑

现在进入最核心的编码环节。我们将创建第一个C#脚本。

4.1 PlayerController脚本：实现蓄力与跳跃

1. 在Project面板的Assets文件夹下右键 -> Create -> C# Script，命名为“PlayerController”。双击用你喜欢的代码编辑器（如Visual Studio）打开。
2. 我们先定义几个关键变量，并获取必要的组件引用：

using UnityEngine; public class PlayerController : MonoBehaviour { // 公开变量，方便在Unity编辑器内调试和调整 public float maxForce = 15f; // 最大跳跃力 public float forceMultiplier = 10f; // 蓄力时间到跳跃力的换算系数 public Transform aimIndicator; // 指向目标的箭头指示器（可选） private Rigidbody rb; private bool isCharging = false; // 是否正在蓄力 private float chargeTime = 0f; // 蓄力时间 private Vector3 jumpDirection; // 跳跃方向（固定向前，即Z轴正方向） void Start() { rb = GetComponent<Rigidbody>(); if (rb == null) { Debug.LogError("PlayerController: Rigidbody component not found!"); } // 初始化跳跃方向为世界坐标的Z轴正方向（向前） jumpDirection = Vector3.forward; // 如果有蓄力指示器，初始隐藏 if (aimIndicator != null) aimIndicator.gameObject.SetActive(false); } }

3. 接下来，在Update函数中处理输入。我们使用鼠标左键模拟触摸屏按压：

void Update() { // 鼠标左键按下（或触摸开始）时开始蓄力 if (Input.GetMouseButtonDown(0)) { StartCharging(); } // 鼠标左键按住期间，持续蓄力 if (isCharging) { chargeTime += Time.deltaTime; // Time.deltaTime是上一帧的时间，保证蓄力增长与帧率无关 // 可以在这里更新蓄力指示器的视觉表现，比如拉长箭头 UpdateAimIndicator(); } // 鼠标左键抬起（或触摸结束）时执行跳跃 if (Input.GetMouseButtonUp(0) && isCharging) { Jump(); } } void StartCharging() { // 只有角色在地面上时才能开始蓄力，防止空中连跳 if (IsGrounded()) { isCharging = true; chargeTime = 0f; if (aimIndicator != null) { aimIndicator.gameObject.SetActive(true); // 将指示器放在角色脚下，并指向跳跃方向 aimIndicator.position = transform.position + Vector3.up * 0.1f; aimIndicator.rotation = Quaternion.LookRotation(jumpDirection); } } } void UpdateAimIndicator() { if (aimIndicator != null) { // 根据蓄力时间改变指示器的长度，直观显示力度 float indicatorLength = Mathf.Clamp(chargeTime * 2f, 0.5f, 3f); aimIndicator.localScale = new Vector3(0.1f, 0.1f, indicatorLength); } }

4. 实现跳跃函数和接地检测：

void Jump() { if (!isCharging) return; // 计算最终的跳跃力，并限制上限 float currentForce = Mathf.Clamp(chargeTime * forceMultiplier, 0, maxForce); // 给刚体施加一个冲力。ForceMode.Impulse表示瞬间施加一个力，适合跳跃 // 力的方向是：向上（Y轴）和向前（Z轴）的组合 Vector3 forceVector = new Vector3(0, 1.5f, 1).normalized * currentForce; rb.AddForce(forceVector, ForceMode.Impulse); // 重置蓄力状态 isCharging = false; chargeTime = 0f; if (aimIndicator != null) aimIndicator.gameObject.SetActive(false); Debug.Log("Jumped with force: " + currentForce); } bool IsGrounded() { // 使用射线检测判断角色是否在地面 // 从角色中心偏下的位置，向下发射一条很短的射线 RaycastHit hit; float rayLength = 0.6f; // 射线长度，略大于角色底部到脚底的距离 Vector3 rayStart = transform.position + Vector3.up * 0.1f; // 从腰部偏下开始 if (Physics.Raycast(rayStart, Vector3.down, out hit, rayLength)) { // 如果射线打到了物体，并且该物体是平台（可以通过Tag或Layer判断） if (hit.collider.CompareTag("Platform")) { return true; } } // 可视化射线，调试时非常有用 Debug.DrawRay(rayStart, Vector3.down * rayLength, Color.green); return false; }

5. 保存脚本，回到Unity。将PlayerController脚本拖拽到Hierarchy中的Player对象上。你会看到Inspector面板出现了我们定义的公共变量。把Max Force和Force Multiplier分别设为15和10（可以先默认，后续调试）。如果创建了蓄力指示器（比如一个细长的Cube），也把它拖拽赋值给Aim Indicator。

4.2 创建平台预制体与生成器

1. 制作平台预制体：
   • 在场景中创建一个新的Cube，重命名为“Platform”，调整Scale为(2, 0.3, 1)。给它一个不同于起跳平台的颜色材质（比如蓝色）。
   • 为它添加Rigidbody，并勾选Is Kinematic和冻结旋转。
   • 关键一步：在Inspector顶部的Tag下拉菜单，点击“Add Tag...”，新建一个Tag命名为“Platform”。然后选中场景中的这个Platform Cube，将它的Tag设置为“Platform”。这样我们的IsGrounded()检测才能生效。
   • 将这个Platform从Hierarchy拖到Project面板的Assets文件夹里。你会看到一个蓝色的预制体（Prefab）图标。之后就可以删除场景中的这个实例了，我们将用代码动态生成它。
2. 编写PlatformSpawner脚本：
   • 创建一个新的C#脚本，命名为“PlatformSpawner”。
   • 这个脚本需要知道：在哪里生成平台（相对于玩家或上一个平台）、平台的预制体是什么、生成的范围有多大。

using UnityEngine; public class PlatformSpawner : MonoBehaviour { public GameObject platformPrefab; // 拖入我们刚创建的Platform预制体 public Transform playerTransform; // 拖入Player对象，用于计算生成位置 public float minDistance = 3f; // 距离玩家的最小生成距离 public float maxDistance = 6f; // 距离玩家的最大生成距离 public float minHeight = -1f; // Y轴的最小偏移（可以生成在下坡） public float maxHeight = 2f; // Y轴的最大偏移（可以生成在上坡） private GameObject lastPlatform; // 记录上一个生成的平台 void Start() { if (platformPrefab == null || playerTransform == null) { Debug.LogError("PlatformSpawner: Prefab or Player reference not set!"); return; } // 游戏开始时，可以生成第一个目标平台（除了起始平台） SpawnNewPlatform(); } // 这个方法将由GameManager或玩家落地时调用 public void SpawnNewPlatform() { // 计算生成位置 Vector3 spawnPosition = CalculateSpawnPosition(); // 实例化平台预制体 lastPlatform = Instantiate(platformPrefab, spawnPosition, Quaternion.identity); // 可以给新平台一个随机的颜色或轻微旋转增加变化 Renderer rend = lastPlatform.GetComponent<Renderer>(); if (rend != null) { rend.material.color = new Color( Random.Range(0.6f, 1f), Random.Range(0.6f, 1f), Random.Range(0.6f, 1f) ); } } Vector3 CalculateSpawnPosition() { // 基础位置：玩家当前位置的前方 Vector3 basePos = playerTransform.position + Vector3.forward * 5f; // 添加随机偏移 float randomX = Random.Range(-2f, 2f); // X轴左右随机 float randomZ = Random.Range(minDistance, maxDistance); // Z轴前后距离随机 float randomY = Random.Range(minHeight, maxHeight); // Y轴高度随机 Vector3 randomOffset = new Vector3(randomX, randomY, randomZ); // 如果存在上一个平台，也可以基于上一个平台的位置生成 // 这里我们选择基于玩家前方生成，逻辑更简单 return basePos + randomOffset; } }

3. 在场景中创建一个空GameObject，重命名为“GameManager”。将PlatformSpawner脚本挂载上去。然后将Project里的Platform预制体拖到脚本的Platform Prefab槽，把Hierarchy里的Player拖到Player Transform槽。

5. 游戏逻辑中枢：实现分数计算与状态管理

游戏能跳了，平台能生了，现在需要把它们串联起来，并加入游戏的核心——分数。

5.1 创建GameManager脚本

1. 新建C#脚本，命名为“GameManager”。
2. 这个脚本将是一个单例（Singleton），方便其他脚本访问。它负责：
   • 管理游戏分数。
   • 判断游戏是否结束（玩家掉落）。
   • 调用平台生成。
   • 控制UI的显示与隐藏。

using UnityEngine; using UnityEngine.UI; // 引入UI命名空间 using UnityEngine.SceneManagement; // 用于重新加载场景 public class GameManager : MonoBehaviour { public static GameManager Instance; // 单例实例 public Text scoreText; // 当前分数UI文本 public Text highScoreText; // 最高分UI文本 public GameObject gameOverPanel; // 游戏结束界面面板 private int currentScore = 0; private int highScore = 0; private bool isGameOver = false; private PlatformSpawner platformSpawner; void Awake() { // 简单的单例模式实现 if (Instance == null) { Instance = this; } else { Destroy(gameObject); } } void Start() { // 加载保存的最高分 highScore = PlayerPrefs.GetInt("HighScore", 0); UpdateHighScoreUI(); // 查找PlatformSpawner组件 platformSpawner = FindObjectOfType<PlatformSpawner>(); if (platformSpawner == null) { Debug.LogError("GameManager: Could not find PlatformSpawner in scene."); } // 隐藏游戏结束面板 if (gameOverPanel != null) gameOverPanel.SetActive(false); } // 当玩家成功落在一个平台上时，由平台或PlayerController调用 public void OnPlayerLanded(Vector3 landingPosition, GameObject platform) { if (isGameOver) return; // 1. 计算本次跳跃得分 int scoreToAdd = CalculateScore(landingPosition, platform); currentScore += scoreToAdd; UpdateScoreUI(); // 2. 检查并更新最高分 if (currentScore > highScore) { highScore = currentScore; PlayerPrefs.SetInt("HighScore", highScore); UpdateHighScoreUI(); // 可以在这里触发一个“新纪录！”特效或音效 } // 3. 生成下一个平台 if (platformSpawner != null) { platformSpawner.SpawnNewPlatform(); } Debug.Log("Landed! Added " + scoreToAdd + " points. Total: " + currentScore); } int CalculateScore(Vector3 landingPos, GameObject platform) { // 基础分：成功着陆就得10分 int baseScore = 10; // 精准度加分：计算落点与平台中心的距离 Vector3 platformCenter = platform.transform.position; float distanceFromCenter = Vector3.Distance( new Vector3(landingPos.x, 0, landingPos.z), // 忽略Y轴高度差 new Vector3(platformCenter.x, 0, platformCenter.z) ); float platformRadius = platform.transform.localScale.x / 2f; // 粗略以X方向半宽作为半径 float accuracyRatio = 1f - Mathf.Clamp01(distanceFromCenter / platformRadius); // 精准度越高，加分越多。例如，落在中心（ratio=1）额外加20分 int bonusScore = Mathf.RoundToInt(20 * accuracyRatio); return baseScore + bonusScore; } // 游戏结束，例如玩家掉出屏幕 public void GameOver() { if (isGameOver) return; isGameOver = true; Debug.Log("Game Over! Final Score: " + currentScore); // 显示游戏结束界面 if (gameOverPanel != null) { gameOverPanel.SetActive(true); // 可以在游戏结束面板上显示最终分数 Text finalScoreText = gameOverPanel.transform.Find("FinalScoreText")?.GetComponent<Text>(); if (finalScoreText != null) finalScoreText.text = "得分: " + currentScore; } // 可以在这里停止玩家输入、播放失败音效等 } // UI更新方法 void UpdateScoreUI() { if (scoreText != null) scoreText.text = "分数: " + currentScore; } void UpdateHighScoreUI() { if (highScoreText != null) highScoreText.text = "最高分: " + highScore; } // 提供给UI按钮调用的方法 public void RestartGame() { // 最简单的方式：重新加载当前场景 SceneManager.LoadScene(SceneManager.GetActiveScene().name); } public void QuitGame() { // 在编辑器里停止播放，在打包后的程序中退出 #if UNITY_EDITOR UnityEditor.EditorApplication.isPlaying = false; #else Application.Quit(); #endif } }

5.2 完善PlayerController的着陆检测与通信

现在需要修改PlayerController脚本，让它能在着陆时通知GameManager。

1. 在PlayerController中添加：

public class PlayerController : MonoBehaviour { // ... 之前已有的变量 ... private bool wasGrounded = false; // 上一帧是否在地面 private GameObject currentPlatform; // 当前站立的平台 void Update() { // ... 原有的输入检测代码 ... // 每帧检测接地状态变化 bool grounded = IsGrounded(); if (!wasGrounded && grounded) { // 刚刚着陆 OnLanded(); } wasGrounded = grounded; // 简单的游戏结束判断：如果角色掉到很深的地方 if (transform.position.y < -10f) { GameManager.Instance?.GameOver(); } } // 修改IsGrounded方法，使其能返回检测到的平台 bool IsGrounded() { RaycastHit hit; float rayLength = 0.6f; Vector3 rayStart = transform.position + Vector3.up * 0.1f; if (Physics.Raycast(rayStart, Vector3.down, out hit, rayLength)) { if (hit.collider.CompareTag("Platform")) { currentPlatform = hit.collider.gameObject; // 记录当前平台 return true; } } Debug.DrawRay(rayStart, Vector3.down * rayLength, Color.green); currentPlatform = null; return false; } void OnLanded() { if (currentPlatform != null) { // 通知GameManager，传递着陆点（角色当前位置）和平台对象 GameManager.Instance?.OnPlayerLanded(transform.position, currentPlatform); } } }

5.3 设置UI界面

1. 在Hierarchy右键 -> UI -> Canvas，创建一个画布。
2. 在Canvas下创建：
   • Text：重命名为“ScoreText”，用于显示当前分数。调整RectTransform，将其锚点(Anchor)设为左上角，调整位置。在Text组件中，设置字体大小、颜色，文本内容设为“分数: 0”。
   • 另一个Text：重命名为“HighScoreText”，用于显示最高分。同样放在左上角，在ScoreText下方。
   • Panel：重命名为“GameOverPanel”。将其锚点拉伸至全屏，并设置一个半透明的背景色（如黑色，Alpha=150）。初始状态取消勾选（SetActive false）。
   • 在GameOverPanel下创建：
     • Text：重命名为“FinalScoreText”，显示“游戏结束！最终分数：”。
     • Button：重命名为“RestartButton”，子Text改为“重新开始”。
     • 另一个Button：重命名为“QuitButton”，子Text改为“退出游戏”。
3. 关联UI元素：
   • 选中场景中的GameManager对象。
   • 将Canvas下的ScoreText和HighScoreText分别拖到GameManager脚本的对应公共变量槽中。
   • 将GameOverPanel整个对象拖到Game Over Panel槽中。
   • 分别为两个UI按钮的OnClick事件添加监听：点击“+”号，将GameManager对象拖入，然后分别选择GameManager.RestartGame和GameManager.QuitGame方法。

6. 打磨与优化：让游戏体验更上一层楼

基础功能都实现了，现在我们来打磨细节，让游戏从“能玩”变成“好玩”。

6.1 摄像机平滑跟随

当前的摄像机是固定的，角色跳远后就出画面了。我们需要一个跟随脚本。

1. 创建C#脚本“CameraFollow”：

using UnityEngine; public class CameraFollow : MonoBehaviour { public Transform target; // 跟随的目标（Player） public Vector3 offset = new Vector3(0, 10, -10); // 摄像机相对于目标的偏移 public float smoothSpeed = 5f; // 跟随平滑度，值越大跟随越紧 void LateUpdate() // 在目标移动后更新摄像机，避免抖动 { if (target == null) return; // 计算期望的摄像机位置 Vector3 desiredPosition = target.position + offset; // 使用线性插值平滑移动 Vector3 smoothedPosition = Vector3.Lerp(transform.position, desiredPosition, smoothSpeed * Time.deltaTime); transform.position = smoothedPosition; // 让摄像机始终看着目标（可选，我们的固定角度可能更好） // transform.LookAt(target); } }

2. 将脚本挂到Main Camera上，把Player对象拖到Target变量中。调整Offset和Smooth Speed直到感觉跟随流畅自然。

6.2 添加音效与简单粒子效果

音效：

1. 准备几个简短的音效文件（.wav或.mp3），如“jump.wav”、“land.wav”、“score.wav”。
2. 将它们导入Unity的Assets文件夹。
3. 在PlayerController的Jump()方法里添加：AudioSource.PlayClipAtPoint(jumpSoundClip, transform.position);
4. 在GameManager的OnPlayerLanded里添加得分音效。

粒子效果：

1. 在Player脚下创建一个粒子系统（Particle System）。右键 -> Effects -> Particle System，重命名为“LandingDust”。
2. 调整粒子参数：Start Lifetime调短（0.5），Start Speed调低，Emission Rate调高，Shape设为半球形朝上。
3. 在PlayerController的OnLanded()方法中，触发这个粒子系统的播放：landingParticles.Play();

6.3 蓄力视觉反馈优化

我们之前用了一个简单的箭头拉伸。可以做得更炫：

1. 使用UI Slider（滑动条）作为蓄力条。在Canvas下创建Slider，将其锚点放在屏幕底部。
2. 将Slider的Handle Slide Area和Handle都禁用或隐藏，只保留Background和Fill Area，让它看起来像一个水平进度条。
3. 在PlayerController中，获取这个Slider的引用，在UpdateAimIndicator方法中，根据chargeTime更新Slider的value：powerSlider.value = chargeTime / (maxForce / forceMultiplier);
4. 还可以改变Fill Area的颜色，从绿色（安全）渐变到红色（最大力）。

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

开发过程中，你几乎一定会遇到下面这些问题。这里是我踩过坑后总结的排查思路。

7.1 角色跳跃无力或直接穿墙而过

• 症状：按下鼠标，角色轻轻动一下，或者根本不动，甚至直接掉下去。
• 排查：
  1. 检查刚体：首先确认Player对象上有Rigidbody组件。没有刚体，AddForce是无效的。
  2. 检查力的大小：在Jump()方法里用Debug.Log打印出计算出的currentForce值。如果一直是0，说明chargeTime没增长，检查StartCharging的触发条件和IsGrounded()的检测是否准确。
  3. 检查力的方向：forceVector的Y和Z分量是否合理？可以尝试先给一个固定的力测试，比如rb.AddForce(Vector3.up * 5f, ForceMode.Impulse);看能否跳起来。
  4. 碰撞体缺失：确保Player和Platform都有Collider组件（Cube默认有Box Collider，Capsule默认有Capsule Collider）。没有Collider，物理碰撞就不会发生，射线检测也会失败。
  5. 图层碰撞矩阵：检查Edit -> Project Settings -> Physics。确保Player和Platform所在图层的“碰撞矩阵”是相互勾选的（默认都是勾选的）。如果修改了图层，这里可能被禁用。

7.2 平台生成位置诡异或重叠

• 症状：新平台生成在奇怪的地方，比如玩家头顶，或者和旧平台叠在一起。
• 排查：
  1. 检查生成位置计算：在PlatformSpawner.CalculateSpawnPosition()方法里，用Debug.DrawLine或Debug.Log打印出计算出的spawnPosition。看看随机偏移量（randomX, randomZ, randomY）的范围是否合理。
  2. 基于谁的位置生成：我们的示例代码是基于玩家当前位置向前生成。如果玩家跳跃过程中位置变化很快，可能导致生成位置飘忽不定。可以考虑基于“上一个成功着陆的平台”的位置来生成下一个，这样逻辑更稳定。
  3. 防止重叠：生成新平台前，可以用Physics.OverlapBox或Physics.CheckSphere检查目标位置周围是否有其他平台，如果有，就重新计算一个位置。

7.3 游戏卡顿，特别是生成多个平台后

• 症状：游戏运行一段时间后越来越卡。
• 排查：
  1. 平台数量无限增长：这是最常见的原因。我们只生成新平台，没有销毁旧平台。玩家跳走后，后面的平台还留在场景里，成百上千个Cube肯定会卡。
  • 解决方案：在PlatformSpawner中维护一个平台列表，当列表长度超过一定数量（比如10个）时，销毁最早生成的那个平台。或者在每个平台离开摄像机视野后（用OnBecameInvisible方法）自我销毁。
  2. 复杂的Update逻辑：检查所有脚本的Update方法，避免在里面进行复杂的计算或每帧查找对象（如FindObjectOfType）。将不变的计算移到Start或缓存起来。
  3. 粒子系统或音频未回收：实例化的粒子或播放的音频源，在播放完毕后要销毁或回收。

7.4 UI按钮点击无反应

• 症状：点击重新开始或退出按钮，什么都没发生。
• 排查：
  1. 事件监听是否正确绑定：在Unity编辑器中，双击检查按钮的OnClick事件列表。确保GameManager对象被正确拖入，并且下拉菜单中选择了正确的方法名（RestartGame或QuitGame）。
  2. GameManager单例是否有效：在游戏运行时，检查Hierarchy中是否存在GameManager对象。如果不存在，GameManager.Instance就是null，按钮调用会失败。
  3. 面板遮挡：确认GameOverPanel在激活时，其Raycast Target是开启的，并且没有其他全屏UI面板遮挡了按钮。

7.5 精准得分计算不准

• 症状：明明感觉跳在平台中心，却没有拿到最高加分。
• 排查：
  1. 着陆点检测时机：OnLanded是在IsGrounded从false变为true时触发的。此时角色的位置可能还在“滑动”或“微调”。可以尝试延迟几帧再计算分数，或者取一个更稳定的位置（如碰撞接触点hit.point）。
  2. 平台中心计算：我们用了platform.transform.position，这是预制体的轴心点(Pivot)。如果你的平台模型轴心不在几何中心，这里就会出错。确保在建模或调整Cube时，其轴心在中心。或者在预制体里放一个空子物体作为“得分中心点”。
  3. 距离计算忽略Y轴：我们的计算用new Vector3(landingPos.x, 0, landingPos.z)把Y轴归零了，这是正确的，因为平台可能有高度差，我们只关心水平面上的落点精度。

走到这一步，你的“跳一跳”已经是一个功能完整、体验流畅的游戏了。从环境搭建、物理交互、代码逻辑到UI和反馈，你已经走完了一个小型Unity项目开发的全流程。这个过程中最重要的不是复现我的每一行代码，而是理解每个决策背后的原因：为什么用刚体而不是直接改Transform？为什么用射线检测接地？单例模式在这里解决了什么问题？

你可以在此基础上继续深化：给平台添加不同的类型（移动平台、破碎平台、加分平台）；为角色添加跳跃动画和落地翻滚；引入连击系统，连续中心着陆获得倍数得分；甚至加入简单的敌人和障碍。这个小小的项目，就像一颗种子，能生长出无数种可能。编程和游戏开发最大的乐趣，就在于看着自己脑海中的想法，通过一行行代码，变成屏幕上鲜活的世界。