1. 项目概述为什么从这15个脚本开始如果你刚打开Unity面对一个空荡荡的场景和复杂的编辑器界面感到无从下手那你来对地方了。我见过太多新手包括当年的我自己一上来就想复刻一个3A大作结果被复杂的物理系统、动画状态机和网络同步搞得头昏脑胀最后热情耗尽项目烂尾。Unity游戏开发的核心或者说任何游戏开发的核心其实不在于那些花哨的视觉效果而在于用代码驱动逻辑。而C#脚本就是你在Unity世界里发号施令的“魔法咒语”。这个“15个基础C#脚本案例”项目目的非常纯粹帮你绕过那些华而不实的理论直接上手写代码在最短的时间内建立起“我能用代码让游戏动起来”的信心。它不会教你如何制作一个完整的游戏但会给你15把最趁手的“螺丝刀”和“扳手”。当你掌握了如何移动一个方块、如何检测一次碰撞、如何播放一段音效之后你会发现那些看似复杂的游戏机制无非是这些基础工具的不同组合与叠加。为什么是15个因为太少不足以覆盖核心操作太多又会让人望而生畏。这15个案例精挑细选几乎涵盖了所有2D/3D小游戏开发中90%的常用功能。从最基础的物体移动旋转到稍微进阶的UI交互、场景管理再到涉及游戏核心逻辑的生成、销毁与数据持久化。每一个案例都独立成篇你可以像搭积木一样任意组合它们来构建你的第一个小游戏比如一个躲避障碍物的小球或者一个简单的平台跳跃demo。对于新手来说最大的障碍往往不是语法而是“不知道从哪里开始”以及“不知道这个功能该用什么API实现”。这个系列就是你的“API速查手册”和“灵感启动器”。当你卡壳时回来翻翻这些案例很可能就能找到解决方案的雏形。2. 核心脚本案例详解与设计思路2.1 案例一物体基础变换移动、旋转、缩放这是所有交互的起点。在Unity中一个游戏对象GameObject的变换Transform组件决定了它在世界中的位置、旋转和大小。对应的C#脚本就是去读写这个组件里的position、rotation和localScale属性。移动Translate最直观的方式是使用Transform.Translate方法。例如让一个物体每帧向右移动transform.Translate(Vector3.right * speed * Time.deltaTime);。这里的关键是Time.deltaTime它表示上一帧到当前帧的时间间隔。乘以它之后移动速度就从“每帧5单位”变成了“每秒5单位”这样无论电脑帧率是30还是144物体的移动速度在现实中看起来都是恒定的。这是新手最容易忽略但至关重要的细节。旋转Rotate同样使用Transform.Rotate方法。比如让一个物体绕Y轴持续旋转transform.Rotate(Vector3.up * rotationSpeed * Time.deltaTime);。你可以传入一个向量分别指定绕X、Y、Z轴旋转的角度。缩放Scale缩放通常不是持续性的而是触发性的。比如吃到“变大”道具。这时直接修改transform.localScale属性即可transform.localScale new Vector3(2f, 2f, 2f);。注意修改的是localScale相对于父物体的缩放而不是lossyScale世界坐标系下的总缩放只读。实操心得对于移动和旋转务必养成乘以Time.deltaTime的习惯。否则你的游戏在不同性能的机器上会完全是两个游戏。另外Translate默认是在物体的自身坐标系下移动比如Vector3.forward是物体面朝的方向如果你希望它在世界坐标系下移动比如永远向世界坐标的右边移动需要传入Space.World参数transform.Translate(Vector3.right * speed * Time.deltaTime, Space.World);。2.2 案例二物理运动与刚体Rigidbody控制当你需要物体有真实的物理特性比如重力、碰撞、弹力时就必须请出刚体Rigidbody组件。通过脚本控制刚体是让运动显得“有重量感”的关键。与直接修改Transform不同对刚体的操作分为两种主要方式施加力AddForce模拟真实的物理推力。比如让小球跳起来rigidbody.AddForce(Vector3.up * jumpForce, ForceMode.Impulse);。ForceMode.Impulse表示瞬间的冲量适合跳跃、射击等。而ForceMode.Force则是持续的力适合模拟火箭推进。直接修改速度velocity有时我们需要更直接的控制比如一个左右移动的平台。可以这样rigidbody.velocity new Vector3(moveHorizontal * speed, rigidbody.velocity.y, 0);。这里只修改了X轴的速度而Y轴速度比如重力下落的速度保持不变这样操作更符合直觉。为什么用刚体而不是Transform如果你想让一个箱子能被角色推动或者让一个球从斜坡上滚下就必须使用刚体。直接修改Transform.position会让物体“穿墙而过”因为它无视了碰撞体Collider。而刚体会与碰撞体互动产生真实的物理反馈。注意事项通过脚本修改刚体的速度或位置时要小心与物理引擎自身的计算产生冲突。例如在同一帧内既用AddForce又直接设置velocity结果可能不可预测。通常运动逻辑在FixedUpdate()函数中处理会比在Update()中更好因为物理计算有自己固定的时间步长Fixed Timestep。2.3 案例三玩家输入处理键盘、鼠标、手柄游戏的核心是交互而交互的起点是输入。Unity提供了一个强大的Input类以及新的Input System包但这里我们先谈经典的。键盘输入最常用的是Input.GetKey(KeyCode.Space)按住空格和Input.GetKeyDown(KeyCode.Space)按下空格的瞬间。后者通常用于触发跳跃、射击等一次性动作。void Update() { if (Input.GetKeyDown(KeyCode.Space)) { Jump(); } float horizontal Input.GetAxis(“Horizontal”); // 获取A/D或左右方向键的平滑输入值在-1到1之间 float vertical Input.GetAxis(“Vertical”); // 获取W/S或上下方向键的平滑输入 }Input.GetAxis非常有用它返回一个经过平滑处理的浮点数直接用于控制移动非常方便无需自己处理按键时长。鼠标输入Input.GetMouseButtonDown(0)对应鼠标左键点击。Input.mousePosition可以获取鼠标在屏幕上的像素坐标但需要用它和摄像机配合通过Camera.ScreenToWorldPoint转换成游戏世界中的坐标才能实现“点击哪里移动到哪里”的功能。设计思路一个好的输入处理脚本应该将“输入检测”和“具体行为”解耦。比如一个PlayerInput脚本只负责收集所有的按键状态并将其转化为一个易于理解的数据结构如一个InputData类包含moveDirection、isJumpPressed等字段。然后另一个PlayerMovement脚本读取这个InputData来执行移动和跳跃。这样当你未来想从键盘切换到手柄时只需要修改PlayerInput脚本而PlayerMovement脚本完全不用动。2.4 案例四碰撞与触发检测这是游戏逻辑的“触发器”。Unity中有两种主要的检测方式碰撞Collision和触发Trigger。碰撞检测当两个物体都带有碰撞体Collider且至少一个带有刚体Rigidbody时如果它们发生物理接触就会产生碰撞。你可以在脚本中定义OnCollisionEnter、OnCollisionStay、OnCollisionExit函数来响应。例如玩家碰到敌人掉血void OnCollisionEnter(Collision collision) { if (collision.gameObject.CompareTag(“Enemy”)) { TakeDamage(10); } }这里用CompareTag来识别碰撞对象比直接比较物体名称gameObject.name更高效、更不易出错。触发检测当你勾选了碰撞体的Is Trigger属性物理引擎将忽略它的碰撞体积但它仍然能检测到与其他碰撞体的重叠。这时需要使用OnTriggerEnter、OnTriggerStay、OnTriggerExit函数。这非常适合用于制作拾取物品、进入区域等效果。比如玩家进入一个光环范围获得增益void OnTriggerEnter(Collider other) { if (other.CompareTag(“BuffZone”)) { EnableBuff(); } }常见坑点确保你的检测函数放在了正确的物体上。例如检测子弹是否击中敌人的逻辑通常写在子弹的脚本里OnCollisionEnter并在其中判断碰撞体是否是敌人。同时要检查碰撞双方的层级Layer设置Unity的物理设置可以决定哪些层之间会发生碰撞或触发错误设置会导致检测完全失效。2.5 案例五实例化与销毁生成与删除物体动态生成和移除物体是游戏充满变化的基础。比如发射子弹、生成敌人、爆炸后产生碎片。实例化Instantiate使用Instantiate方法。你需要一个预制体Prefab作为模板。预制体是你预先在项目中配置好的一个游戏对象。public GameObject bulletPrefab; // 在Inspector面板中拖入子弹预制体 public Transform firePoint; // 发射点 void Fire() { GameObject newBullet Instantiate(bulletPrefab, firePoint.position, firePoint.rotation); // 可以进一步设置新子弹的属性比如给它一个初始速度 newBullet.GetComponentRigidbody().velocity firePoint.forward * bulletSpeed; }关键点Instantiate会返回对新创建物体的引用你可以立即对它进行配置比如设置速度、伤害值等。销毁Destroy使用Destroy方法。可以销毁其他物体也可以销毁脚本所在的自身物体。void OnCollisionEnter(Collision collision) { // 子弹击中目标后销毁子弹自身 Destroy(gameObject); // 如果击中敌人也销毁敌人 if (collision.gameObject.CompareTag(“Enemy”)) { Destroy(collision.gameObject); } }性能警告频繁地Instantiate和Destroy会产生内存碎片影响性能。对于需要大量重复生成和销毁的对象如子弹、特效成熟的方案是使用对象池Object Pooling。对象池预先创建一批对象并禁用需要时激活并取出用完后再放回池中禁用而不是真正销毁。虽然这超出了最基础的范畴但它是性能优化中极其重要的一环新手在项目稍具规模后必须考虑。2.6 案例六UI交互基础按钮、滑块、文本现代游戏离不开UI。Unity的UGUI系统让创建界面变得直观。脚本与UI交互的核心是获取UI组件的引用并响应其事件。获取与修改UI组件using UnityEngine.UI; // 必须引用UI命名空间 public Text scoreText; // 拖入UI中的Text组件 public Slider healthSlider; // 拖入Slider组件 void Start() { scoreText.text “Score: 0”; // 修改文本内容 healthSlider.maxValue 100; // 设置滑块最大值 healthSlider.value currentHealth; // 设置滑块当前值 }响应UI事件以按钮为例传统方式代码绑定在脚本中定义一个public Button myButton在Inspector中拖入按钮。然后在Start方法中为其添加监听void Start() { myButton.onClick.AddListener(OnButtonClicked); } void OnButtonClicked() { Debug.Log(“按钮被点击了”); }编辑器方式可视化绑定直接在Unity编辑器的按钮组件上点击“On Click()”下方的“”号将拥有脚本的游戏对象拖入然后在下拉菜单中选择对应的方法。这种方式更直观但耦合度稍高。UI更新时机UI的更新如更新分数显示通常放在Update()函数里但这可能造成每帧都更新即使数据没变。更高效的做法是只在数据真正改变时才更新UI。这可以通过属性Property的set访问器或发布-订阅模式来实现但对于新手先掌握每帧更新也没问题。2.7 案例七协程Coroutine实现延时与间隔Update函数每帧执行但有时我们需要“等待”一段时间再执行某个操作比如技能冷却、延时爆炸、物体渐隐。这时Update配合计时器变量会显得很笨拙而协程就是为这种场景而生的利器。协程是一个能暂停执行并在下一帧或指定时间后继续执行的函数。它用IEnumerator作为返回类型并使用yield return语句来暂停。基础延时IEnumerator DestroyAfterDelay() { yield return new WaitForSeconds(3.0f); // 暂停3秒 Destroy(gameObject); // 3秒后执行销毁 } void Start() { StartCoroutine(DestroyAfterDelay()); // 启动协程 }间隔执行IEnumerator SpawnEnemyWave() { for(int i 0; i 5; i) { Instantiate(enemyPrefab, spawnPoint.position, Quaternion.identity); yield return new WaitForSeconds(1.0f); // 每生成一个敌人等待1秒 } }与Invoke的区别Unity也提供了Invoke(“FunctionName”, delayTime)和InvokeRepeating来实现延时和重复调用。但协程更强大、更灵活可读性协程的代码是顺序执行的逻辑更清晰。灵活性可以在循环中任意位置yield可以等待多种条件如WaitForEndOfFrame,WaitUntil。可控性可以用StopCoroutine来精确停止某个协程而CancelInvoke只能停止所有该函数名的调用。重要警告协程不是线程它仍然运行在主线程上。不要在协程里执行阻塞性的耗时操作如同步读取大文件否则整个游戏都会卡住。另外当承载协程的物体被销毁Destroy时其上的所有协程会自动停止。2.8 案例八单例模式与游戏管理器随着游戏功能增多你会需要一些“全局管理者”比如管理游戏状态开始、进行中、结束、保存最高分、管理音效播放等。让这些管理器在整个游戏中有且只有一个实例并且能方便地被任何脚本访问这就是单例模式Singleton的用武之地。一个简单的游戏管理器单例实现public class GameManager : MonoBehaviour { public static GameManager Instance; // 静态实例全局可访问 public int totalScore; public bool isGameOver; void Awake() { // 确保只有一个实例存在 if (Instance null) { Instance this; DontDestroyOnLoad(gameObject); // 可选切换场景时不销毁 } else { Destroy(gameObject); // 如果已存在则销毁新创建的 } } public void AddScore(int points) { totalScore points; // 可以在这里触发UI更新事件 Debug.Log(“当前分数: ” totalScore); } }在其他任何脚本中你都可以这样访问管理器的功能GameManager.Instance.AddScore(100);。设计考量单例非常方便但要谨慎使用。过度使用单例会导致代码高度耦合难以测试和维护。它最适合用于真正的、唯一的全局服务。对于像“玩家状态”这种可能在未来需要存在多个比如本地分屏游戏就不适合用全局单例而应考虑通过其他方式如查找、依赖注入来获取引用。2.9 案例九场景加载与管理游戏通常由多个场景Scene组成如开始菜单、关卡1、关卡2、结束画面。Unity提供了SceneManager类来管理场景。加载新场景using UnityEngine.SceneManagement; public void LoadNextLevel() { // 通过场景名称加载 SceneManager.LoadScene(“Level2”); // 或通过场景在Build Settings中的索引加载 // SceneManager.LoadScene(1); }SceneManager.LoadScene是同步加载游戏会卡住直到新场景加载完毕。对于大场景会造成明显的卡顿。异步加载推荐为了不阻塞游戏可以使用协程进行异步加载同时显示一个加载界面。public GameObject loadingScreen; // 加载中界面 public Slider progressBar; // 进度条 IEnumerator LoadLevelAsync(string sceneName) { AsyncOperation operation SceneManager.LoadSceneAsync(sceneName); operation.allowSceneActivation false; // 先不自动激活新场景 loadingScreen.SetActive(true); while (!operation.isDone) { float progress Mathf.Clamp01(operation.progress / 0.9f); // operation.progress最大到0.9 progressBar.value progress; if (progress 0.9f) { // 加载完成等待玩家按下任意键再激活场景 // 或者直接激活operation.allowSceneActivation true; yield return new WaitUntil(() Input.anyKeyDown); operation.allowSceneActivation true; } yield return null; } }场景间传递数据LoadScene会清空当前场景的所有对象。如果需要在场景间传递数据如玩家分数、选择的角色有几种常见方法使用单例模式且标记为DontDestroyOnLoad的游戏管理器。使用Unity提供的ScriptableObject来创建可持久化的数据资产。使用静态类或静态变量简单但不够面向对象。2.10 案例十音频播放与控制声音是游戏体验的一半。Unity的音频系统核心是AudioSource组件播放器和AudioClip资源音频文件。播放一次音效如跳跃、射击public AudioClip jumpSound; private AudioSource audioSource; void Start() { audioSource GetComponentAudioSource(); } void Jump() { // 逻辑代码... audioSource.PlayOneShot(jumpSound); // PlayOneShot适合播放短促、可能重叠的音效 }播放背景音乐public AudioClip bgm; void Start() { audioSource.clip bgm; audioSource.loop true; // 设置为循环 audioSource.Play(); }控制音量可以通过AudioSource的volume属性控制单个音源音量也可以通过AudioListener.volume通常挂在主摄像机上控制全局音量。// 控制背景音乐音量 audioSource.volume 0.5f; // 控制全局音量影响所有声音 AudioListener.volume 0.7f;进阶技巧为了更精细地管理音效如单独控制音乐、音效、环境声的音量通常会创建一个音频管理器单例。这个管理器持有多个AudioSource并对外提供如PlaySFX(AudioClip clip)、SetMusicVolume(float vol)这样的接口。这样任何脚本想播放音效只需调用AudioManager.Instance.PlaySFX(jumpSound);而不需要每个对象都挂载AudioSource。2.11 案例十一动画状态机与脚本控制对于有复杂动画的角色如待机、行走、奔跑、跳跃Unity的Animator组件和动画状态机Animation State Machine是标准工具。脚本的工作是根据游戏逻辑如速度、是否在地面来切换动画状态。获取Animator组件并设置参数private Animator animator; private Rigidbody rb; void Start() { animator GetComponentAnimator(); rb GetComponentRigidbody(); } void Update() { // 计算水平速度大小 float speed new Vector3(rb.velocity.x, 0, rb.velocity.z).magnitude; // 将速度值传递给Animator中名为“Speed”的浮点型参数 animator.SetFloat(“Speed”, speed); // 根据是否在地面设置布尔型参数“IsGrounded” animator.SetBool(“IsGrounded”, IsGrounded()); }在Animator Controller中你需要定义状态如Idle, Walk, Run和转换条件Transition。这些条件就基于上面脚本设置的参数如Speed 0.1从Idle转到Walk。触发一次性动画对于攻击、受伤等不循环的动画通常使用Trigger参数。public void PlayAttackAnimation() { animator.SetTrigger(“Attack”); // 触发名为“Attack”的触发器 }在Animator中设置一个从Any State或当前状态到Attack状态的转换条件就是这个“Attack” Trigger。Trigger被触发一次后会自动重置。避坑指南动画状态机的设计要避免状态“打架”。比如同时满足“Speed0.1”和“IsGroundedfalse”时应该优先播放跳跃动画还是行走动画这需要通过设置状态的层级Layer、权重Weight或使用子状态机来理清优先级。另外过度使用SetTrigger而忘记在动画结束后重置状态或使用Exit Time自动过渡可能导致Trigger“卡住”下次无法触发。确保动画片段后有足够长的Exit Time或者使用脚本在动画事件中重置状态。2.12 案例十二数据持久化PlayerPrefs与JSON游戏需要保存玩家的进度、设置和最高分。Unity提供了最简单的PlayerPrefs适合存储少量简单的数据整数、浮点数、字符串。使用PlayerPrefs// 保存数据 PlayerPrefs.SetInt(“HighScore”, 100); PlayerPrefs.SetString(“PlayerName”, “新手开发者”); PlayerPrefs.Save(); // 写入磁盘建议在关键点调用 // 读取数据 int highScore PlayerPrefs.GetInt(“HighScore”, 0); // 第二个参数是默认值 string name PlayerPrefs.GetString(“PlayerName”, “Guest”);PlayerPrefs的局限性它本质上是将数据以明文形式保存在系统注册表Windows或plist文件Mac中玩家可以轻易修改安全性为零。且不适合存储复杂结构的数据如背包里所有物品的列表。使用JSON存储复杂数据对于需要保存角色属性、物品清单等结构化数据序列化为JSON字符串再存储是更通用的方法。可以使用Unity自带的JsonUtility或更强大的第三方库如Newtonsoft.Json。using UnityEngine; [System.Serializable] // 必须标记为可序列化 public class SaveData { public int level; public float health; public Liststring inventoryItems; } public class DataManager : MonoBehaviour { private SaveData currentSave; public void SaveGame() { string json JsonUtility.ToJson(currentSave); System.IO.File.WriteAllText(Application.persistentDataPath “/save.json”, json); } public void LoadGame() { string path Application.persistentDataPath “/save.json”; if (System.IO.File.Exists(path)) { string json System.IO.File.ReadAllText(path); currentSave JsonUtility.FromJsonSaveData(json); } else { currentSave new SaveData(); // 新建存档 } } }Application.persistentDataPath是Unity提供的跨平台持久化数据路径不同设备位置不同。用JSON文件存储数据相对结构化但依然是明文的。对于商业项目通常还需要对JSON字符串进行加密。2.13 案例十三射线检测Raycast的应用射线检测是从空间中某一点沿一个方向发射一条无形的射线检测沿途碰撞到的物体。这是实现第一人称射击、鼠标点击选择、角色视线判断等功能的基石。从摄像机发射射线实现鼠标点击选择物体void Update() { if (Input.GetMouseButtonDown(0)) { // 鼠标左键点击 Ray ray Camera.main.ScreenPointToRay(Input.mousePosition); RaycastHit hit; // 存储碰撞信息 if (Physics.Raycast(ray, out hit)) { // 如果射线击中了某个碰撞体 GameObject clickedObject hit.collider.gameObject; Debug.Log(“点击了: ” clickedObject.name); // 可以获取碰撞点坐标 Vector3 hitPoint hit.point; } } }从物体自身发射射线实现地面检测用于跳跃public bool IsGrounded() { // 从物体底部向下发射一条短射线 Ray ray new Ray(transform.position, Vector3.down); float rayLength 1.1f; // 比角色高度稍长一点 // 使用Raycast的重载方法只检测特定层如“Ground”层提高效率 if (Physics.Raycast(ray, rayLength, LayerMask.GetMask(“Ground”))) { return true; } return false; }Physics.Raycast有很多重载方法可以指定射线长度、检测的层级掩码LayerMask、是否忽略触发器等灵活运用可以极大优化性能。球形射线检测SphereCast有时需要检测一个体积而不仅仅是一条线。比如判断角色前方是否有足够空间通过可以用Physics.SphereCast它发射的是一个球体。性能提示射线检测是物理计算每帧进行大量射线检测比如成百上千次会带来性能开销。应尽量避免在Update中每帧对大量物体进行检测。常见的优化手段包括增加检测间隔如每0.1秒检测一次、使用层级过滤减少检测对象、将结果缓存起来复用。2.14 案例十四时间控制Time.timeScale与增量时间Unity的Time类提供了控制游戏时间流的强大工具这对于实现慢动作、暂停游戏等功能至关重要。Time.timeScale这是控制游戏整体时间流速的缩放系数。Time.timeScale 1.0f;// 正常速度Time.timeScale 0.5f;// 慢动作所有基于时间的操作物理、动画、协程中的WaitForSeconds都会变慢一半。Time.timeScale 0.0f;// 完全暂停。但请注意这并不会停止Update()函数的执行只会停止依赖于时间的功能。实现游戏暂停bool isPaused false; void TogglePause() { isPaused !isPaused; Time.timeScale isPaused ? 0f : 1f; // 通常还需要暂停音频 AudioListener.pause isPaused; // 以及显示/隐藏暂停菜单UI pauseMenuUI.SetActive(isPaused); }Time.deltaTime 与 Time.unscaledDeltaTimeTime.deltaTime上一帧到当前帧的时间间隔受Time.timeScale影响。我们在移动物体时乘以它就是为了让运动速度与真实时间同步。当timeScale0时deltaTime也为0。Time.unscaledDeltaTime不受Time.timeScale影响的真实时间增量。当你希望在游戏暂停时UI动画、菜单倒计时还能正常进行就需要使用它。void Update() { // 即使游戏暂停这个计时器也会用真实时间递减 if (isPaused) { uiTimer - Time.unscaledDeltaTime; } }2.15 案例十五委托与事件实现松散耦合随着脚本越来越多脚本之间的通信会变得混乱。比如玩家得分时需要更新UI、播放音效、可能还要触发成就系统。如果让玩家脚本直接去调用UI脚本、音效脚本的方法代码会高度耦合难以维护。委托Delegate和事件Event是解决这个问题的优雅方案它们实现了“发布-订阅”模式。基础用法// 1. 定义委托和事件通常在GameManager或一个专门的事件管理类中 public class GameEvents : MonoBehaviour { // 定义一个无参数无返回值的委托类型 public delegate void ScoreChangedAction(int newScore); // 基于该委托类型声明一个事件 public static event ScoreChangedAction OnScoreChanged; // 一个触发事件的方法 public static void TriggerScoreChanged(int score) { // 检查是否有订阅者然后触发事件 OnScoreChanged?.Invoke(score); } } // 2. 发布者Player脚本当得分时 public class Player : MonoBehaviour { void AddScore(int points) { currentScore points; // 不再直接调用其他脚本而是触发事件 GameEvents.TriggerScoreChanged(currentScore); } } // 3. 订阅者UIManager脚本需要响应分数变化 public class UIManager : MonoBehaviour { void OnEnable() { // 订阅事件 GameEvents.OnScoreChanged UpdateScoreUI; } void OnDisable() { // 非常重要取消订阅防止内存泄漏 GameEvents.OnScoreChanged - UpdateScoreUI; } void UpdateScoreUI(int score) { scoreText.text “分数: ” score; } }优势现在Player脚本完全不知道UIManager的存在。我们可以轻松地让音效管理器、成就系统也来订阅OnScoreChanged事件而无需修改Player脚本一行代码。这极大地降低了代码的耦合度提高了可扩展性和可维护性。核心要点使用事件时务必在OnEnable中订阅在OnDisable或OnDestroy中取消订阅。否则当订阅者物体被销毁后事件发布者仍持有对它的引用会导致错误和内存泄漏。对于静态事件尤其要注意这一点。3. 从案例到项目组合应用实战掌握了这15个基础脚本你已经拥有了构建一个简单但完整游戏demo的所有零件。让我们以制作一个2D平台跳跃游戏为例看看如何将它们组合起来玩家移动案例二三使用Rigidbody2D和Input.GetAxis(“Horizontal”)控制左右移动用AddForce或直接设置velocity实现跳跃。地面检测案例十三使用Physics2D.Raycast或BoxCast从玩家脚底向下发射射线判断是否接触地面用于限制空中连跳。相机跟随案例一写一个简单的脚本挂在摄像机上在LateUpdate中平滑地将其position设置为玩家位置加上一个偏移量。生成与销毁案例五设计一些移动的平台或敌人当玩家碰到尖刺触发检测案例四时调用Destroy让玩家“死亡”然后从检查点重生可能涉及场景加载或位置重置。收集物品案例四六创建一些“金币”预制体带有Trigger碰撞体。玩家碰到时触发OnTriggerEnter2D调用GameManager.Instance.AddScore(10)案例八并Destroy金币。同时UIManager通过订阅OnScoreChanged事件案例十五来实时更新UI上的分数显示。游戏状态管理案例八九GameManager单例管理isGameOver状态。当玩家掉出地图或生命值为零时触发游戏结束事件显示“Game Over”UI案例六并允许玩家按R键重新加载当前场景案例九。音效与动画案例十十一玩家跳跃、收集金币、死亡时播放对应的AudioClip。将玩家的速度、是否在地面等参数传递给Animator控制待机、奔跑、跳跃动画的切换。通过这样一个项目的实践你会真切地感受到每一个独立的脚本案例是如何像齿轮一样咬合在一起驱动起一个完整的游戏循环。这个过程中调试Debug.Log、协程做延时重生、时间控制暂停功能等都会自然地被用到。4. 避坑指南与进阶学习路径4.1 新手常犯的五个错误及解决方法忘记使用Time.deltaTime导致游戏速度与帧率绑定。解决所有与运动、动画、计时相关的连续变化只要希望与真实时间同步就乘以Time.deltaTime物理相关操作在FixedUpdate中用Time.fixedDeltaTime。在Update中频繁使用Find或GetComponentGameObject.Find、GetComponent是比较耗时的操作。解决在Start或Awake中获取组件引用并缓存到私有变量中在Update里重复使用。// 错误做法 void Update() { GameObject player GameObject.Find(“Player”); // 每帧都查找非常低效 } // 正确做法 private GameObject player; void Start() { player GameObject.Find(“Player”); // 只查找一次 }协程或Invoke函数名拼写错误StartCoroutine(“MyCoroutine”)或Invoke(“MyFunction”, 1f)中使用字符串方法名如果方法名拼错编译器不会报错但运行时无效。解决尽量使用传递方法引用的方式StartCoroutine(MyCoroutine())和Invoke(nameof(MyFunction), 1f)C# 6.0的nameof关键字可以避免拼写错误。物理操作放在Update而不是FixedUpdate对刚体施加力或修改速度放在Update中会因为帧率不稳定导致物理表现不一致。解决所有直接操作Rigidbody的代码都应放在FixedUpdate中。不处理空引用异常NullReferenceException这是Unity开发中最常见的错误。解决在使用通过GetComponent或Find获取的引用前先判断是否为空。private Rigidbody rb; void Start() { rb GetComponentRigidbody(); if (rb null) { Debug.LogError(“该物体上没有找到Rigidbody组件”, this); } }4.2 下一步学什么清晰的进阶路线当你熟练运用这15个基础脚本后可以沿着以下路径深入状态模式与有限状态机FSM用于管理角色复杂的状态如待机、移动、攻击、受伤比简单的Animator参数控制更清晰、更强大。有很多可视化插件如PlayMaker或代码框架如Unity的ScriptableObject架构可供学习。对象池Object Pooling如前所述这是优化性能的必备技能用于管理子弹、敌人、特效等频繁生成销毁的对象。新的输入系统Input System PackageUnity新的Input System比传统的Input类更强大、更灵活支持跨平台输入重映射是未来趋势。ScriptableObject用于创建不依赖于场景的数据容器和逻辑脚本非常适合配置游戏数据如武器属性、技能效果、创建事件系统、实现轻量级的架构。Unity的UI系统优化了解Canvas的渲染模式、Draw Call合批规则学会使用RectMask2D、Content Size Fitter等组件动态布局对于制作复杂界面至关重要。寻路与AI学习使用Unity的NavMesh系统让AI自动寻路结合行为树Behavior Tree或状态机打造更智能的敌人。资源管理与Addressables学习如何异步加载资源使用Addressable Asset System来管理庞大的游戏资源实现资源热更新。学习的过程就是不断用这些小工具去搭建更复杂结构的过程。不要试图一次性掌握所有东西。选定一个小目标比如“做一个Flappy Bird”然后去实现它遇到不会的就查文档、搜社区。在解决问题的过程中你的知识体系会自然而然地构建起来。记住在游戏开发中动手做出一个哪怕很简陋但能运行的原型其价值也远大于阅读一百篇教程。
1. 项目概述为什么从这15个脚本开始如果你刚打开Unity面对一个空荡荡的场景和复杂的编辑器界面感到无从下手那你来对地方了。我见过太多新手包括当年的我自己一上来就想复刻一个3A大作结果被复杂的物理系统、动画状态机和网络同步搞得头昏脑胀最后热情耗尽项目烂尾。Unity游戏开发的核心或者说任何游戏开发的核心其实不在于那些花哨的视觉效果而在于用代码驱动逻辑。而C#脚本就是你在Unity世界里发号施令的“魔法咒语”。这个“15个基础C#脚本案例”项目目的非常纯粹帮你绕过那些华而不实的理论直接上手写代码在最短的时间内建立起“我能用代码让游戏动起来”的信心。它不会教你如何制作一个完整的游戏但会给你15把最趁手的“螺丝刀”和“扳手”。当你掌握了如何移动一个方块、如何检测一次碰撞、如何播放一段音效之后你会发现那些看似复杂的游戏机制无非是这些基础工具的不同组合与叠加。为什么是15个因为太少不足以覆盖核心操作太多又会让人望而生畏。这15个案例精挑细选几乎涵盖了所有2D/3D小游戏开发中90%的常用功能。从最基础的物体移动旋转到稍微进阶的UI交互、场景管理再到涉及游戏核心逻辑的生成、销毁与数据持久化。每一个案例都独立成篇你可以像搭积木一样任意组合它们来构建你的第一个小游戏比如一个躲避障碍物的小球或者一个简单的平台跳跃demo。对于新手来说最大的障碍往往不是语法而是“不知道从哪里开始”以及“不知道这个功能该用什么API实现”。这个系列就是你的“API速查手册”和“灵感启动器”。当你卡壳时回来翻翻这些案例很可能就能找到解决方案的雏形。2. 核心脚本案例详解与设计思路2.1 案例一物体基础变换移动、旋转、缩放这是所有交互的起点。在Unity中一个游戏对象GameObject的变换Transform组件决定了它在世界中的位置、旋转和大小。对应的C#脚本就是去读写这个组件里的position、rotation和localScale属性。移动Translate最直观的方式是使用Transform.Translate方法。例如让一个物体每帧向右移动transform.Translate(Vector3.right * speed * Time.deltaTime);。这里的关键是Time.deltaTime它表示上一帧到当前帧的时间间隔。乘以它之后移动速度就从“每帧5单位”变成了“每秒5单位”这样无论电脑帧率是30还是144物体的移动速度在现实中看起来都是恒定的。这是新手最容易忽略但至关重要的细节。旋转Rotate同样使用Transform.Rotate方法。比如让一个物体绕Y轴持续旋转transform.Rotate(Vector3.up * rotationSpeed * Time.deltaTime);。你可以传入一个向量分别指定绕X、Y、Z轴旋转的角度。缩放Scale缩放通常不是持续性的而是触发性的。比如吃到“变大”道具。这时直接修改transform.localScale属性即可transform.localScale new Vector3(2f, 2f, 2f);。注意修改的是localScale相对于父物体的缩放而不是lossyScale世界坐标系下的总缩放只读。实操心得对于移动和旋转务必养成乘以Time.deltaTime的习惯。否则你的游戏在不同性能的机器上会完全是两个游戏。另外Translate默认是在物体的自身坐标系下移动比如Vector3.forward是物体面朝的方向如果你希望它在世界坐标系下移动比如永远向世界坐标的右边移动需要传入Space.World参数transform.Translate(Vector3.right * speed * Time.deltaTime, Space.World);。2.2 案例二物理运动与刚体Rigidbody控制当你需要物体有真实的物理特性比如重力、碰撞、弹力时就必须请出刚体Rigidbody组件。通过脚本控制刚体是让运动显得“有重量感”的关键。与直接修改Transform不同对刚体的操作分为两种主要方式施加力AddForce模拟真实的物理推力。比如让小球跳起来rigidbody.AddForce(Vector3.up * jumpForce, ForceMode.Impulse);。ForceMode.Impulse表示瞬间的冲量适合跳跃、射击等。而ForceMode.Force则是持续的力适合模拟火箭推进。直接修改速度velocity有时我们需要更直接的控制比如一个左右移动的平台。可以这样rigidbody.velocity new Vector3(moveHorizontal * speed, rigidbody.velocity.y, 0);。这里只修改了X轴的速度而Y轴速度比如重力下落的速度保持不变这样操作更符合直觉。为什么用刚体而不是Transform如果你想让一个箱子能被角色推动或者让一个球从斜坡上滚下就必须使用刚体。直接修改Transform.position会让物体“穿墙而过”因为它无视了碰撞体Collider。而刚体会与碰撞体互动产生真实的物理反馈。注意事项通过脚本修改刚体的速度或位置时要小心与物理引擎自身的计算产生冲突。例如在同一帧内既用AddForce又直接设置velocity结果可能不可预测。通常运动逻辑在FixedUpdate()函数中处理会比在Update()中更好因为物理计算有自己固定的时间步长Fixed Timestep。2.3 案例三玩家输入处理键盘、鼠标、手柄游戏的核心是交互而交互的起点是输入。Unity提供了一个强大的Input类以及新的Input System包但这里我们先谈经典的。键盘输入最常用的是Input.GetKey(KeyCode.Space)按住空格和Input.GetKeyDown(KeyCode.Space)按下空格的瞬间。后者通常用于触发跳跃、射击等一次性动作。void Update() { if (Input.GetKeyDown(KeyCode.Space)) { Jump(); } float horizontal Input.GetAxis(“Horizontal”); // 获取A/D或左右方向键的平滑输入值在-1到1之间 float vertical Input.GetAxis(“Vertical”); // 获取W/S或上下方向键的平滑输入 }Input.GetAxis非常有用它返回一个经过平滑处理的浮点数直接用于控制移动非常方便无需自己处理按键时长。鼠标输入Input.GetMouseButtonDown(0)对应鼠标左键点击。Input.mousePosition可以获取鼠标在屏幕上的像素坐标但需要用它和摄像机配合通过Camera.ScreenToWorldPoint转换成游戏世界中的坐标才能实现“点击哪里移动到哪里”的功能。设计思路一个好的输入处理脚本应该将“输入检测”和“具体行为”解耦。比如一个PlayerInput脚本只负责收集所有的按键状态并将其转化为一个易于理解的数据结构如一个InputData类包含moveDirection、isJumpPressed等字段。然后另一个PlayerMovement脚本读取这个InputData来执行移动和跳跃。这样当你未来想从键盘切换到手柄时只需要修改PlayerInput脚本而PlayerMovement脚本完全不用动。2.4 案例四碰撞与触发检测这是游戏逻辑的“触发器”。Unity中有两种主要的检测方式碰撞Collision和触发Trigger。碰撞检测当两个物体都带有碰撞体Collider且至少一个带有刚体Rigidbody时如果它们发生物理接触就会产生碰撞。你可以在脚本中定义OnCollisionEnter、OnCollisionStay、OnCollisionExit函数来响应。例如玩家碰到敌人掉血void OnCollisionEnter(Collision collision) { if (collision.gameObject.CompareTag(“Enemy”)) { TakeDamage(10); } }这里用CompareTag来识别碰撞对象比直接比较物体名称gameObject.name更高效、更不易出错。触发检测当你勾选了碰撞体的Is Trigger属性物理引擎将忽略它的碰撞体积但它仍然能检测到与其他碰撞体的重叠。这时需要使用OnTriggerEnter、OnTriggerStay、OnTriggerExit函数。这非常适合用于制作拾取物品、进入区域等效果。比如玩家进入一个光环范围获得增益void OnTriggerEnter(Collider other) { if (other.CompareTag(“BuffZone”)) { EnableBuff(); } }常见坑点确保你的检测函数放在了正确的物体上。例如检测子弹是否击中敌人的逻辑通常写在子弹的脚本里OnCollisionEnter并在其中判断碰撞体是否是敌人。同时要检查碰撞双方的层级Layer设置Unity的物理设置可以决定哪些层之间会发生碰撞或触发错误设置会导致检测完全失效。2.5 案例五实例化与销毁生成与删除物体动态生成和移除物体是游戏充满变化的基础。比如发射子弹、生成敌人、爆炸后产生碎片。实例化Instantiate使用Instantiate方法。你需要一个预制体Prefab作为模板。预制体是你预先在项目中配置好的一个游戏对象。public GameObject bulletPrefab; // 在Inspector面板中拖入子弹预制体 public Transform firePoint; // 发射点 void Fire() { GameObject newBullet Instantiate(bulletPrefab, firePoint.position, firePoint.rotation); // 可以进一步设置新子弹的属性比如给它一个初始速度 newBullet.GetComponentRigidbody().velocity firePoint.forward * bulletSpeed; }关键点Instantiate会返回对新创建物体的引用你可以立即对它进行配置比如设置速度、伤害值等。销毁Destroy使用Destroy方法。可以销毁其他物体也可以销毁脚本所在的自身物体。void OnCollisionEnter(Collision collision) { // 子弹击中目标后销毁子弹自身 Destroy(gameObject); // 如果击中敌人也销毁敌人 if (collision.gameObject.CompareTag(“Enemy”)) { Destroy(collision.gameObject); } }性能警告频繁地Instantiate和Destroy会产生内存碎片影响性能。对于需要大量重复生成和销毁的对象如子弹、特效成熟的方案是使用对象池Object Pooling。对象池预先创建一批对象并禁用需要时激活并取出用完后再放回池中禁用而不是真正销毁。虽然这超出了最基础的范畴但它是性能优化中极其重要的一环新手在项目稍具规模后必须考虑。2.6 案例六UI交互基础按钮、滑块、文本现代游戏离不开UI。Unity的UGUI系统让创建界面变得直观。脚本与UI交互的核心是获取UI组件的引用并响应其事件。获取与修改UI组件using UnityEngine.UI; // 必须引用UI命名空间 public Text scoreText; // 拖入UI中的Text组件 public Slider healthSlider; // 拖入Slider组件 void Start() { scoreText.text “Score: 0”; // 修改文本内容 healthSlider.maxValue 100; // 设置滑块最大值 healthSlider.value currentHealth; // 设置滑块当前值 }响应UI事件以按钮为例传统方式代码绑定在脚本中定义一个public Button myButton在Inspector中拖入按钮。然后在Start方法中为其添加监听void Start() { myButton.onClick.AddListener(OnButtonClicked); } void OnButtonClicked() { Debug.Log(“按钮被点击了”); }编辑器方式可视化绑定直接在Unity编辑器的按钮组件上点击“On Click()”下方的“”号将拥有脚本的游戏对象拖入然后在下拉菜单中选择对应的方法。这种方式更直观但耦合度稍高。UI更新时机UI的更新如更新分数显示通常放在Update()函数里但这可能造成每帧都更新即使数据没变。更高效的做法是只在数据真正改变时才更新UI。这可以通过属性Property的set访问器或发布-订阅模式来实现但对于新手先掌握每帧更新也没问题。2.7 案例七协程Coroutine实现延时与间隔Update函数每帧执行但有时我们需要“等待”一段时间再执行某个操作比如技能冷却、延时爆炸、物体渐隐。这时Update配合计时器变量会显得很笨拙而协程就是为这种场景而生的利器。协程是一个能暂停执行并在下一帧或指定时间后继续执行的函数。它用IEnumerator作为返回类型并使用yield return语句来暂停。基础延时IEnumerator DestroyAfterDelay() { yield return new WaitForSeconds(3.0f); // 暂停3秒 Destroy(gameObject); // 3秒后执行销毁 } void Start() { StartCoroutine(DestroyAfterDelay()); // 启动协程 }间隔执行IEnumerator SpawnEnemyWave() { for(int i 0; i 5; i) { Instantiate(enemyPrefab, spawnPoint.position, Quaternion.identity); yield return new WaitForSeconds(1.0f); // 每生成一个敌人等待1秒 } }与Invoke的区别Unity也提供了Invoke(“FunctionName”, delayTime)和InvokeRepeating来实现延时和重复调用。但协程更强大、更灵活可读性协程的代码是顺序执行的逻辑更清晰。灵活性可以在循环中任意位置yield可以等待多种条件如WaitForEndOfFrame,WaitUntil。可控性可以用StopCoroutine来精确停止某个协程而CancelInvoke只能停止所有该函数名的调用。重要警告协程不是线程它仍然运行在主线程上。不要在协程里执行阻塞性的耗时操作如同步读取大文件否则整个游戏都会卡住。另外当承载协程的物体被销毁Destroy时其上的所有协程会自动停止。2.8 案例八单例模式与游戏管理器随着游戏功能增多你会需要一些“全局管理者”比如管理游戏状态开始、进行中、结束、保存最高分、管理音效播放等。让这些管理器在整个游戏中有且只有一个实例并且能方便地被任何脚本访问这就是单例模式Singleton的用武之地。一个简单的游戏管理器单例实现public class GameManager : MonoBehaviour { public static GameManager Instance; // 静态实例全局可访问 public int totalScore; public bool isGameOver; void Awake() { // 确保只有一个实例存在 if (Instance null) { Instance this; DontDestroyOnLoad(gameObject); // 可选切换场景时不销毁 } else { Destroy(gameObject); // 如果已存在则销毁新创建的 } } public void AddScore(int points) { totalScore points; // 可以在这里触发UI更新事件 Debug.Log(“当前分数: ” totalScore); } }在其他任何脚本中你都可以这样访问管理器的功能GameManager.Instance.AddScore(100);。设计考量单例非常方便但要谨慎使用。过度使用单例会导致代码高度耦合难以测试和维护。它最适合用于真正的、唯一的全局服务。对于像“玩家状态”这种可能在未来需要存在多个比如本地分屏游戏就不适合用全局单例而应考虑通过其他方式如查找、依赖注入来获取引用。2.9 案例九场景加载与管理游戏通常由多个场景Scene组成如开始菜单、关卡1、关卡2、结束画面。Unity提供了SceneManager类来管理场景。加载新场景using UnityEngine.SceneManagement; public void LoadNextLevel() { // 通过场景名称加载 SceneManager.LoadScene(“Level2”); // 或通过场景在Build Settings中的索引加载 // SceneManager.LoadScene(1); }SceneManager.LoadScene是同步加载游戏会卡住直到新场景加载完毕。对于大场景会造成明显的卡顿。异步加载推荐为了不阻塞游戏可以使用协程进行异步加载同时显示一个加载界面。public GameObject loadingScreen; // 加载中界面 public Slider progressBar; // 进度条 IEnumerator LoadLevelAsync(string sceneName) { AsyncOperation operation SceneManager.LoadSceneAsync(sceneName); operation.allowSceneActivation false; // 先不自动激活新场景 loadingScreen.SetActive(true); while (!operation.isDone) { float progress Mathf.Clamp01(operation.progress / 0.9f); // operation.progress最大到0.9 progressBar.value progress; if (progress 0.9f) { // 加载完成等待玩家按下任意键再激活场景 // 或者直接激活operation.allowSceneActivation true; yield return new WaitUntil(() Input.anyKeyDown); operation.allowSceneActivation true; } yield return null; } }场景间传递数据LoadScene会清空当前场景的所有对象。如果需要在场景间传递数据如玩家分数、选择的角色有几种常见方法使用单例模式且标记为DontDestroyOnLoad的游戏管理器。使用Unity提供的ScriptableObject来创建可持久化的数据资产。使用静态类或静态变量简单但不够面向对象。2.10 案例十音频播放与控制声音是游戏体验的一半。Unity的音频系统核心是AudioSource组件播放器和AudioClip资源音频文件。播放一次音效如跳跃、射击public AudioClip jumpSound; private AudioSource audioSource; void Start() { audioSource GetComponentAudioSource(); } void Jump() { // 逻辑代码... audioSource.PlayOneShot(jumpSound); // PlayOneShot适合播放短促、可能重叠的音效 }播放背景音乐public AudioClip bgm; void Start() { audioSource.clip bgm; audioSource.loop true; // 设置为循环 audioSource.Play(); }控制音量可以通过AudioSource的volume属性控制单个音源音量也可以通过AudioListener.volume通常挂在主摄像机上控制全局音量。// 控制背景音乐音量 audioSource.volume 0.5f; // 控制全局音量影响所有声音 AudioListener.volume 0.7f;进阶技巧为了更精细地管理音效如单独控制音乐、音效、环境声的音量通常会创建一个音频管理器单例。这个管理器持有多个AudioSource并对外提供如PlaySFX(AudioClip clip)、SetMusicVolume(float vol)这样的接口。这样任何脚本想播放音效只需调用AudioManager.Instance.PlaySFX(jumpSound);而不需要每个对象都挂载AudioSource。2.11 案例十一动画状态机与脚本控制对于有复杂动画的角色如待机、行走、奔跑、跳跃Unity的Animator组件和动画状态机Animation State Machine是标准工具。脚本的工作是根据游戏逻辑如速度、是否在地面来切换动画状态。获取Animator组件并设置参数private Animator animator; private Rigidbody rb; void Start() { animator GetComponentAnimator(); rb GetComponentRigidbody(); } void Update() { // 计算水平速度大小 float speed new Vector3(rb.velocity.x, 0, rb.velocity.z).magnitude; // 将速度值传递给Animator中名为“Speed”的浮点型参数 animator.SetFloat(“Speed”, speed); // 根据是否在地面设置布尔型参数“IsGrounded” animator.SetBool(“IsGrounded”, IsGrounded()); }在Animator Controller中你需要定义状态如Idle, Walk, Run和转换条件Transition。这些条件就基于上面脚本设置的参数如Speed 0.1从Idle转到Walk。触发一次性动画对于攻击、受伤等不循环的动画通常使用Trigger参数。public void PlayAttackAnimation() { animator.SetTrigger(“Attack”); // 触发名为“Attack”的触发器 }在Animator中设置一个从Any State或当前状态到Attack状态的转换条件就是这个“Attack” Trigger。Trigger被触发一次后会自动重置。避坑指南动画状态机的设计要避免状态“打架”。比如同时满足“Speed0.1”和“IsGroundedfalse”时应该优先播放跳跃动画还是行走动画这需要通过设置状态的层级Layer、权重Weight或使用子状态机来理清优先级。另外过度使用SetTrigger而忘记在动画结束后重置状态或使用Exit Time自动过渡可能导致Trigger“卡住”下次无法触发。确保动画片段后有足够长的Exit Time或者使用脚本在动画事件中重置状态。2.12 案例十二数据持久化PlayerPrefs与JSON游戏需要保存玩家的进度、设置和最高分。Unity提供了最简单的PlayerPrefs适合存储少量简单的数据整数、浮点数、字符串。使用PlayerPrefs// 保存数据 PlayerPrefs.SetInt(“HighScore”, 100); PlayerPrefs.SetString(“PlayerName”, “新手开发者”); PlayerPrefs.Save(); // 写入磁盘建议在关键点调用 // 读取数据 int highScore PlayerPrefs.GetInt(“HighScore”, 0); // 第二个参数是默认值 string name PlayerPrefs.GetString(“PlayerName”, “Guest”);PlayerPrefs的局限性它本质上是将数据以明文形式保存在系统注册表Windows或plist文件Mac中玩家可以轻易修改安全性为零。且不适合存储复杂结构的数据如背包里所有物品的列表。使用JSON存储复杂数据对于需要保存角色属性、物品清单等结构化数据序列化为JSON字符串再存储是更通用的方法。可以使用Unity自带的JsonUtility或更强大的第三方库如Newtonsoft.Json。using UnityEngine; [System.Serializable] // 必须标记为可序列化 public class SaveData { public int level; public float health; public Liststring inventoryItems; } public class DataManager : MonoBehaviour { private SaveData currentSave; public void SaveGame() { string json JsonUtility.ToJson(currentSave); System.IO.File.WriteAllText(Application.persistentDataPath “/save.json”, json); } public void LoadGame() { string path Application.persistentDataPath “/save.json”; if (System.IO.File.Exists(path)) { string json System.IO.File.ReadAllText(path); currentSave JsonUtility.FromJsonSaveData(json); } else { currentSave new SaveData(); // 新建存档 } } }Application.persistentDataPath是Unity提供的跨平台持久化数据路径不同设备位置不同。用JSON文件存储数据相对结构化但依然是明文的。对于商业项目通常还需要对JSON字符串进行加密。2.13 案例十三射线检测Raycast的应用射线检测是从空间中某一点沿一个方向发射一条无形的射线检测沿途碰撞到的物体。这是实现第一人称射击、鼠标点击选择、角色视线判断等功能的基石。从摄像机发射射线实现鼠标点击选择物体void Update() { if (Input.GetMouseButtonDown(0)) { // 鼠标左键点击 Ray ray Camera.main.ScreenPointToRay(Input.mousePosition); RaycastHit hit; // 存储碰撞信息 if (Physics.Raycast(ray, out hit)) { // 如果射线击中了某个碰撞体 GameObject clickedObject hit.collider.gameObject; Debug.Log(“点击了: ” clickedObject.name); // 可以获取碰撞点坐标 Vector3 hitPoint hit.point; } } }从物体自身发射射线实现地面检测用于跳跃public bool IsGrounded() { // 从物体底部向下发射一条短射线 Ray ray new Ray(transform.position, Vector3.down); float rayLength 1.1f; // 比角色高度稍长一点 // 使用Raycast的重载方法只检测特定层如“Ground”层提高效率 if (Physics.Raycast(ray, rayLength, LayerMask.GetMask(“Ground”))) { return true; } return false; }Physics.Raycast有很多重载方法可以指定射线长度、检测的层级掩码LayerMask、是否忽略触发器等灵活运用可以极大优化性能。球形射线检测SphereCast有时需要检测一个体积而不仅仅是一条线。比如判断角色前方是否有足够空间通过可以用Physics.SphereCast它发射的是一个球体。性能提示射线检测是物理计算每帧进行大量射线检测比如成百上千次会带来性能开销。应尽量避免在Update中每帧对大量物体进行检测。常见的优化手段包括增加检测间隔如每0.1秒检测一次、使用层级过滤减少检测对象、将结果缓存起来复用。2.14 案例十四时间控制Time.timeScale与增量时间Unity的Time类提供了控制游戏时间流的强大工具这对于实现慢动作、暂停游戏等功能至关重要。Time.timeScale这是控制游戏整体时间流速的缩放系数。Time.timeScale 1.0f;// 正常速度Time.timeScale 0.5f;// 慢动作所有基于时间的操作物理、动画、协程中的WaitForSeconds都会变慢一半。Time.timeScale 0.0f;// 完全暂停。但请注意这并不会停止Update()函数的执行只会停止依赖于时间的功能。实现游戏暂停bool isPaused false; void TogglePause() { isPaused !isPaused; Time.timeScale isPaused ? 0f : 1f; // 通常还需要暂停音频 AudioListener.pause isPaused; // 以及显示/隐藏暂停菜单UI pauseMenuUI.SetActive(isPaused); }Time.deltaTime 与 Time.unscaledDeltaTimeTime.deltaTime上一帧到当前帧的时间间隔受Time.timeScale影响。我们在移动物体时乘以它就是为了让运动速度与真实时间同步。当timeScale0时deltaTime也为0。Time.unscaledDeltaTime不受Time.timeScale影响的真实时间增量。当你希望在游戏暂停时UI动画、菜单倒计时还能正常进行就需要使用它。void Update() { // 即使游戏暂停这个计时器也会用真实时间递减 if (isPaused) { uiTimer - Time.unscaledDeltaTime; } }2.15 案例十五委托与事件实现松散耦合随着脚本越来越多脚本之间的通信会变得混乱。比如玩家得分时需要更新UI、播放音效、可能还要触发成就系统。如果让玩家脚本直接去调用UI脚本、音效脚本的方法代码会高度耦合难以维护。委托Delegate和事件Event是解决这个问题的优雅方案它们实现了“发布-订阅”模式。基础用法// 1. 定义委托和事件通常在GameManager或一个专门的事件管理类中 public class GameEvents : MonoBehaviour { // 定义一个无参数无返回值的委托类型 public delegate void ScoreChangedAction(int newScore); // 基于该委托类型声明一个事件 public static event ScoreChangedAction OnScoreChanged; // 一个触发事件的方法 public static void TriggerScoreChanged(int score) { // 检查是否有订阅者然后触发事件 OnScoreChanged?.Invoke(score); } } // 2. 发布者Player脚本当得分时 public class Player : MonoBehaviour { void AddScore(int points) { currentScore points; // 不再直接调用其他脚本而是触发事件 GameEvents.TriggerScoreChanged(currentScore); } } // 3. 订阅者UIManager脚本需要响应分数变化 public class UIManager : MonoBehaviour { void OnEnable() { // 订阅事件 GameEvents.OnScoreChanged UpdateScoreUI; } void OnDisable() { // 非常重要取消订阅防止内存泄漏 GameEvents.OnScoreChanged - UpdateScoreUI; } void UpdateScoreUI(int score) { scoreText.text “分数: ” score; } }优势现在Player脚本完全不知道UIManager的存在。我们可以轻松地让音效管理器、成就系统也来订阅OnScoreChanged事件而无需修改Player脚本一行代码。这极大地降低了代码的耦合度提高了可扩展性和可维护性。核心要点使用事件时务必在OnEnable中订阅在OnDisable或OnDestroy中取消订阅。否则当订阅者物体被销毁后事件发布者仍持有对它的引用会导致错误和内存泄漏。对于静态事件尤其要注意这一点。3. 从案例到项目组合应用实战掌握了这15个基础脚本你已经拥有了构建一个简单但完整游戏demo的所有零件。让我们以制作一个2D平台跳跃游戏为例看看如何将它们组合起来玩家移动案例二三使用Rigidbody2D和Input.GetAxis(“Horizontal”)控制左右移动用AddForce或直接设置velocity实现跳跃。地面检测案例十三使用Physics2D.Raycast或BoxCast从玩家脚底向下发射射线判断是否接触地面用于限制空中连跳。相机跟随案例一写一个简单的脚本挂在摄像机上在LateUpdate中平滑地将其position设置为玩家位置加上一个偏移量。生成与销毁案例五设计一些移动的平台或敌人当玩家碰到尖刺触发检测案例四时调用Destroy让玩家“死亡”然后从检查点重生可能涉及场景加载或位置重置。收集物品案例四六创建一些“金币”预制体带有Trigger碰撞体。玩家碰到时触发OnTriggerEnter2D调用GameManager.Instance.AddScore(10)案例八并Destroy金币。同时UIManager通过订阅OnScoreChanged事件案例十五来实时更新UI上的分数显示。游戏状态管理案例八九GameManager单例管理isGameOver状态。当玩家掉出地图或生命值为零时触发游戏结束事件显示“Game Over”UI案例六并允许玩家按R键重新加载当前场景案例九。音效与动画案例十十一玩家跳跃、收集金币、死亡时播放对应的AudioClip。将玩家的速度、是否在地面等参数传递给Animator控制待机、奔跑、跳跃动画的切换。通过这样一个项目的实践你会真切地感受到每一个独立的脚本案例是如何像齿轮一样咬合在一起驱动起一个完整的游戏循环。这个过程中调试Debug.Log、协程做延时重生、时间控制暂停功能等都会自然地被用到。4. 避坑指南与进阶学习路径4.1 新手常犯的五个错误及解决方法忘记使用Time.deltaTime导致游戏速度与帧率绑定。解决所有与运动、动画、计时相关的连续变化只要希望与真实时间同步就乘以Time.deltaTime物理相关操作在FixedUpdate中用Time.fixedDeltaTime。在Update中频繁使用Find或GetComponentGameObject.Find、GetComponent是比较耗时的操作。解决在Start或Awake中获取组件引用并缓存到私有变量中在Update里重复使用。// 错误做法 void Update() { GameObject player GameObject.Find(“Player”); // 每帧都查找非常低效 } // 正确做法 private GameObject player; void Start() { player GameObject.Find(“Player”); // 只查找一次 }协程或Invoke函数名拼写错误StartCoroutine(“MyCoroutine”)或Invoke(“MyFunction”, 1f)中使用字符串方法名如果方法名拼错编译器不会报错但运行时无效。解决尽量使用传递方法引用的方式StartCoroutine(MyCoroutine())和Invoke(nameof(MyFunction), 1f)C# 6.0的nameof关键字可以避免拼写错误。物理操作放在Update而不是FixedUpdate对刚体施加力或修改速度放在Update中会因为帧率不稳定导致物理表现不一致。解决所有直接操作Rigidbody的代码都应放在FixedUpdate中。不处理空引用异常NullReferenceException这是Unity开发中最常见的错误。解决在使用通过GetComponent或Find获取的引用前先判断是否为空。private Rigidbody rb; void Start() { rb GetComponentRigidbody(); if (rb null) { Debug.LogError(“该物体上没有找到Rigidbody组件”, this); } }4.2 下一步学什么清晰的进阶路线当你熟练运用这15个基础脚本后可以沿着以下路径深入状态模式与有限状态机FSM用于管理角色复杂的状态如待机、移动、攻击、受伤比简单的Animator参数控制更清晰、更强大。有很多可视化插件如PlayMaker或代码框架如Unity的ScriptableObject架构可供学习。对象池Object Pooling如前所述这是优化性能的必备技能用于管理子弹、敌人、特效等频繁生成销毁的对象。新的输入系统Input System PackageUnity新的Input System比传统的Input类更强大、更灵活支持跨平台输入重映射是未来趋势。ScriptableObject用于创建不依赖于场景的数据容器和逻辑脚本非常适合配置游戏数据如武器属性、技能效果、创建事件系统、实现轻量级的架构。Unity的UI系统优化了解Canvas的渲染模式、Draw Call合批规则学会使用RectMask2D、Content Size Fitter等组件动态布局对于制作复杂界面至关重要。寻路与AI学习使用Unity的NavMesh系统让AI自动寻路结合行为树Behavior Tree或状态机打造更智能的敌人。资源管理与Addressables学习如何异步加载资源使用Addressable Asset System来管理庞大的游戏资源实现资源热更新。学习的过程就是不断用这些小工具去搭建更复杂结构的过程。不要试图一次性掌握所有东西。选定一个小目标比如“做一个Flappy Bird”然后去实现它遇到不会的就查文档、搜社区。在解决问题的过程中你的知识体系会自然而然地构建起来。记住在游戏开发中动手做出一个哪怕很简陋但能运行的原型其价值也远大于阅读一百篇教程。
