简介Unity3D游戏开发学习者适用的四合一实例源码包定位明确专为想要二次开发、巩固基础或从零上手Unity的初学者准备提供可直接运行与改造的Demo工程。资源以zip压缩包发布整体约439KB体积精简而内容集中适合快速下载后导入Unity Hub进行分模块对照学习目前已有2348人浏览学习关注度较高。实例内容覆盖角色移动与碰撞检测、UI交互、粒子系统、刚体物理模拟、动画状态机控制、光照阴影调节及C#脚本编程等Unity常用功能模块能够帮助读者理解CharacterController、Canvas/Button、ParticleSystem、Rigidbody、Animator等核心组件的实际配合方式部分源码中还延伸涉及场景管理、资源加载乃至多人网络同步的话题。通过研究源码组织与逻辑写法初学者不仅能积累常见游戏机制的设计经验还能掌握组件化开发与调试排错的基本思路为独立完成小游戏项目提供参考框架。1. 拆解前先反直觉四个实例源码该从哪个开始看拿到这套 Unity3D 四个常用实例源码包很多人习惯按文件名顺序打开结果第一个移动 Demo 就把新手卡住了。实际拆过这类包的人会反过来看先拆 UI 和粒子这类独立模块再回头啃移动与物理最后用资源加载把工程串起来。整套源码覆盖 CharacterController 角色控制、ugui 事件绑定、粒子发射器参数、Rigidbody 与 Joint 约束、Animator 状态机与 AssetBundle 加载适合刚学完 C# 语法、想跑通一个完整 Unity3D 小游戏的初学者也适合需要现成源码做二次开发的从业者。接下来按拆包验证过的顺序讲实现细节和参数坑。2. 角色移动与碰撞检测CharacterController 和物理层的取舍2.1 为什么移动 Demo 用 CharacterController 而不是 Rigidbody第一个实例演示角色移动与碰撞检测时大部分源码都会在场景里挂一个第三人称或第一人称控制器。这里最常见的实现是用 CharacterController而不是直接给角色挂 Rigidbody。原因在于 Rigidbody 的移动是物理引擎驱动的任何碰撞都会产生反弹力矩做平台跳跃时需要额外锁旋转、处理摩擦力和加力否则角色一碰墙就歪。CharacterController 本质上是一个胶囊体形状的物理体积但它不参与物理引擎的动力学求解而是由脚本主动调用 Move 或 SimpleMove 来驱动位置变化。这意味着它能被碰撞阻挡、能检测是否落地却不会被碰撞产生的力推走。对主角控制来说这套行为比 Rigidbody 稳定得多。两者核心差异可以这样归纳维度CharacterControllerRigidbody Collider移动方式代码调用 Move / SimpleMove通过 velocity 或 AddForce重力处理脚本手动计算引擎自动施加碰撞反馈只阻挡不反弹完全物理响应适用场景主角、NPC 控制可拾取物体、载具、物理谜题选择依据可以这样判断凡是需要被捡起、被打飞、参与重量计算的物体用 Rigidbody凡是承载玩家输入、需要精确位置控制的角色用 CharacterController。源码里如果出现两者混用通常是用 Rigidbody 承载角色碰撞体再用脚本来约束旋转这种做法在联机同步时会有额外开销移动 Demo 里没必要。2.2 移动脚本与跳跃手感参数怎么调移动 Demo 的核心脚本通常长这样我按实例源码里最常见的写法重写了一遍using UnityEngine; public class PlayerMovement : MonoBehaviour { [Header(移动参数)] public float moveSpeed 6f; public float jumpSpeed 8f; public float gravity 20f; private CharacterController controller; private Vector3 moveDirection Vector3.zero; void Start() { // CharacterController 必须提前在 Inspector 里挂好 controller GetComponentCharacterController(); } void Update() { // 只有角色落地时才允许重新计算水平方向和跳跃 if (controller.isGrounded) { float h Input.GetAxis(Horizontal); float v Input.GetAxis(Vertical); moveDirection new Vector3(h, 0f, v); moveDirection transform.TransformDirection(moveDirection); moveDirection * moveSpeed; if (Input.GetButtonDown(Jump)) { moveDirection.y jumpSpeed; } } // 重力始终累加离开地面后立即进入下落状态 moveDirection.y - gravity * Time.deltaTime; // Move 的参数是位移量所以乘 Time.deltaTime 转成每秒速度 controller.Move(moveDirection * Time.deltaTime); } }这段脚本的关键在 Update 里手动累加重力而不是依赖 Rigidbody 的重力。isGrounded是 CharacterController 的只读属性每帧检测胶囊体底部是否接触地面只有它为 true 时才允许触发跳跃。moveDirection.y - gravity * Time.deltaTime放在if外面目的是让角色在离开地面后的每一帧都处于下落状态这也是跳跃弧线能成立的根本原因。跳跃高度的精确计算是h v² / (2g)。把jumpSpeed设为 8、gravity设为 20最高点约8 × 8 / (2 × 20) 1.6米对应一个标准角色的半身高度。想调高跳优先改jumpSpeedgravity尽量保持稳定因为它同时影响下落加速曲线改大了角色会跳得矮、落地也更快。移动手感上moveSpeed超过 10 后角色会像滑冰因为这里没有做加速度和摩擦模拟属于这个实例源码的简化边界。提示Time.deltaTime在 Update 里是帧间隔在 FixedUpdate 里请换成Time.fixedDeltaTime。把移动逻辑写进 FixedUpdate 再配controller.Move会遇到运动卡顿因为 CharacterController 的默认更新顺序和物理步进频率并不完全对齐。2.3 碰撞检测两种姿势OverlapSphere 与 Collider 事件实例里第二类碰撞检测是用Physics.OverlapSphere或OnTriggerEnter判断角色周围是否有敌人、道具或可用物体。OverlapSphere是主动检测适合每帧查询角色周围的可交互对象public float checkRadius 2f; public LayerMask targetLayer; void Update() { // 以自身位置为球心按指定 Layer 检测周围碰撞体 Collider[] hits Physics.OverlapSphere(transform.position, checkRadius, targetLayer); foreach (Collider hit in hits) { // 只处理距离最近的那一个避免多目标同时响应 if (Vector3.Distance(transform.position, hit.transform.position) checkRadius) { Debug.Log(检测到目标: hit.name, hit.gameObject); } } }OverlapSphere的第一个参数是检测中心点第二个是半径第三个是 LayerMask 位掩码。LayerMask 用名字转索引再左移的方式构造1 LayerMask.NameToLayer(Enemy)。不加掩码会检测所有碰撞体包括地面和远处的静态物体每帧 GC 分配也会明显上升。实例源码里如果出现频繁调用OverlapSphere的做法我一般会改成定时检测或只在交互按键触发时检测一次性能差别在移动端很明显。被动检测分两类Trigger 和 Collision。挂着 Collider 且勾选isTrigger的体积只做重叠判断不参与物理阻挡适合当拾取区域不勾选isTrigger则产生物理碰撞会触发OnCollisionEnter。两者底层走的不是同一套求解路径Trigger 不改变物体运动轨迹碰撞事件才会真正影响刚体运动。做伤害判定用 Trigger做反弹或推动效果用 Collision。遍历掉落物时会发现OnTriggerEnter有个参数叫Collider而OnCollisionEnter是Collision两者提供了不同的数据接口后者可以读取contactCount和单个接触点这在做弹壳弹射方向判断时特别有用。3. UI 响应链与粒子特效两个独立模块的抄作业要点3.1 Canvas Render Mode 与 EventSystemButton 不响应的常见原因UI 实例是四个 Demo 里最容易被抄错的部分。Button 不响应点击是 ugui 里最常见的坑。原因多数不在 Button 自身而在 Canvas 和 EventSystem 的配置。Canvas 的 Render Mode 有三种Screen Space – Overlay 直接渲染在屏幕上事件计算量最小Screen Space – Camera 挂到指定相机上适合做 UI 跟随场景透视World Space 把 UI 放到世界空间常用于血条和手柄交互。每张 Canvas 默认带一个GraphicRaycaster它是 UI 射线检测的入口。EventSystem 负责把鼠标触摸事件分发给 GraphicRaycaster。实例 Demo 里如果场景缺少 EventSystemButton 的OnClick永远不触发而且不报错。这也是为什么拆 UI 源码时先在 Hierarchy 面板确认 EventSystem 存在再看 Canvas 的sortingOrder。两个 Canvas 重叠时sortingOrder大的先接收射线把 Debug 用的按钮放在高 sortingOrder 层会挡住游戏主界面的点击事件。3.2 代码绑定 Button 事件与防重复点击源码里 UI 逻辑一般有两种写法。第一种是把按钮拖到 Inspector 的 OnClick 列表指认目标对象和回调方法这种方式在改预制体时容易丢引用第二种是脚本里动态注册适合通过代码批量生成按钮的场景。事件响应也可以脱离 Button 组件直接用指针接口这类写法灵活性更高using UnityEngine; using UnityEngine.UI; using System.Collections; public class UIController : MonoBehaviour { public Button startButton; public Animator uiAnimator; void Start() { // 代码注册点击回调lambda 可以捕获当前上下文 startButton.onClick.AddListener(() { // 先置灰防止连点触发两次场景切换 startButton.interactable false; StartCoroutine(SwitchSceneRoutine()); }); } IEnumerator SwitchSceneRoutine() { // 播放 UI 过渡动画后再切换场景 uiAnimator.SetTrigger(FadeOut); yield return new WaitForSeconds(1f); UnityEngine.SceneManagement.SceneManager.LoadScene(Level01); } }onClick.AddListener接收的是 UnityAction 委托Lambda 写法方便捕获当前上下文。防重复点击的常见做法是进入回调后先把interactable置 false等流程结束再恢复用协程等待动画播完再切场景比在 Update 里写计时器更直观。如果实例里还有 Animator Controller 挂到按钮上注意 UI 动画和事件回调的顺序OnClick在点击抬起时触发调SetTrigger播放动画时置灰状态会被 UI 过渡效果覆盖所以要先置灰再播动画。注意EventSystem 缺失时Button 不报任何错误。场景里出现按钮不可点的第一个检查项就是 Hierarchy 里有没有 EventSystem 节点。第二个检查项是 Canvas 上有没有 GraphicRaycaster第三个才是看 Button 的 Image 是否有可点击区域。3.3 粒子系统参数表从默认值到爆炸视觉粒子系统实例通常演示的是武器射击或爆炸特效。理解配置顺序比记住参数更重要先定持续时间再定发射数量与速度最后调颜色和尺寸变化。下面这组参数由实例源码里的爆炸效果整理而来参数推荐值作用Duration0.5–1.0控制特效播放总时长Start Lifetime0.8–1.5每个粒子从出生到消失的秒数Start Speed5–12粒子飞散初速Start Size0.2–0.8粒子初始大小Start Color橙黄 到 深红渐变模拟火光到烟尘的温度变化Gravity Modifier0.1–0.5粒子受重力影响程度太高会快速下落ShapeSphere球形发射面适合爆炸Emission Rate50–200每秒发射粒子数把粒子系统挂到武器 muzzle 的常见误区是直接拖成子物体然后不管位置导致特效在角色转身时穿模。我一般会在武器骨架下单独建一个空节点作为发射点粒子系统挂空节点用代码在开火时调用Play、在退弹时调用Stop。通过GetComponentParticleSystem()拿引用后按参数顺序覆盖默认值即可。爆炸特效还要额外看Max Particles默认 1000 在一个粒子系统上可能不够但调到 5000 以上又会拖内存实际开发里优先用对象池循环复用而不是让每个特效独立创建销毁。4. 物理模拟与动画状态机Rigidbody、Joint 与 Animator 的联动4.1 Rigidbody 质量、碰撞矩阵与穿透排查物理与刚体动力学实例主要是让物体受重力、碰撞反弹、互相连接。Rigidbody 上最关键的参数是mass、drag和angularDrag。mass 不是越重掉得越快物理引擎里同样遵循自由落体规律同一场景里两个不同质量的物体下落速度相同除非阻力系数不同。mass 的真正意义在动量交换大质量物体撞小质量物体小物体获得更大的速度变化。常见问题有两个。一是物体被高速推动时穿透墙体Unity 默认的碰撞检测是 Discrete隔了一帧物体已经穿过了碰撞体。解决方法是把高速移动物体的 Collider 的 Collision Detection 改成 Continuous同时把Time.fixedDeltaTime从默认 0.02 调小到 0.01代价是物理步进次数翻倍压力会转移到 CPU。二是碰撞矩阵没配好不同 Layer 之间互相碰撞导致不该反弹的物体被顶飞。Layer Collision Matrix面板里不需要碰撞的两层之间取消勾选即可这个矩阵是按 Layer 名索引的新增 Layer 后要重新检查一遍。提示排查穿透时先看物体的运动速度单位。0.02 秒的物理步进下速度超过 50m/s 的物体单帧位移就超过 1 米普通的 Box Collider 很难稳定拦截。这类场景优先考虑缩短步进或改用射线检测做提前量判断。4.2 Joint 组件实现弹簧、铰链与绳索约束Joint 相关组件是实现物体间连接的核心。实例里实现弹簧平台或绳索场景时最常见的是 SpringJoint 和 HingeJoint。SpringJoint 会让两个物体之间保持一个弹性距离适合做机关跳台using UnityEngine; public class SpringBridge : MonoBehaviour { public Rigidbody anchorBody; void Start() { // 动态创建弹簧关节并挂到当前物体上 SpringJoint spring gameObject.AddComponentSpringJoint(); // connectedBody 指向固定锚点不能指向自身 spring.connectedBody anchorBody; // spring 表示弹性强度damper 表示振动衰减 spring.spring 50f; spring.damper 2f; // 限制弹簧最大拉伸距离 spring.minDistance 0f; spring.maxDistance 3f; // 自动配置锚点让连接点贴近两个物体表面 spring.autoConfigureConnectedAnchor true; } }anchor是当前物体上的连接点connectedAnchor是目标刚体上的连接点autoConfigureConnectedAnchor为 true 时引擎会按两个物体的质心自动计算连接位置大多数机关场景够用。spring决定弹性强度数值越大回弹越快damper控制振动衰减太小物体会一直抖。调参顺序是先设一个适中的spring再逐步加大damper直到不弹跳。HingeJoint 适合做门和摇臂限制旋转范围用 Limits 选项里的min和max角度。注意 HingeJoint 的connectedBody不能是当前物体自身否则运行时会自碰撞并输出警告。4.3 Animator 状态机用代码驱动过渡与动作打断动画实例用的是 Animator Controller 状态机。源码里控制动画的代码核心其实只有几行using UnityEngine; public class PlayerAnimator : MonoBehaviour { public Animator animator; // 指向角色身上的 Animator 组件 void Update() { float currentSpeed new Vector3( Input.GetAxis(Horizontal), 0f, Input.GetAxis(Vertical) ).magnitude; // Speed 参数用于 Idle 和 Run 之间的平滑过渡 animator.SetFloat(Speed, currentSpeed, 0.1f, Time.deltaTime); // Attack 是 Trigger 参数触发后状态机会自动重置 if (Input.GetMouseButtonDown(0)) { animator.SetTrigger(Attack); } // Jump 是 Bool 参数需要配合状态退出时手动复位 if (Input.GetButtonDown(Jump)) { animator.SetBool(Jump, true); } } }SetFloat的第三、四个参数是阻尼时间和帧间隔用来控制数值变化曲线比直接赋值更平滑。Has Exit Time如果开着则必须播完当前动画才能跳转做动作打断时必须关掉并把 Transition Duration 调到 0.05~0.1 秒否则攻击前摇会明显变长。Trigger 与 Bool 的差别在于Trigger 会在状态切换完成后被自动重置Bool 需要自己在动画事件或代码里复位否则角色会一直保持攻击状态。状态机里常用的参数类型可以这样规划参数名类型用途SpeedFloat行走与跑步动画的混合权重JumpBool跳跃与落地状态切换AttackTrigger攻击动画的一次性触发HurtTrigger受击打断优先级高于攻击动画实例最容易踩的坑是过渡箭头太多状态机复杂到没法维护。我一般只保留符合游戏逻辑的过渡Idle 到 Run、Run 到 Attack、Any State 到 Hurt其余全部删掉。Any State 的过渡权重必须低于正常状态间过渡否则任意动画都会被打断。5. 进阶排错光照阴影、AssetBundle 加载与性能验证5.1 光照参数与阴影距离调整光照与阴影实例通常包含一盏 Directional Light 和几盏点光源。方向光不需要位置概念Rotation 决定阴影方向和角度。阴影质量优先看QualitySettings.shadowDistance默认 50 到 80 米在移动端会产生大量阴影绘制开销安卓平台我一般压到 30 到 40 米。调小后远景阴影消失是正常现象用烘焙光照贴图补充即可。两个模型的表面如果完全重合会出现 z-fighting 的闪烁通常表现为上层材质穿透看见下层结构。调试时想看清被遮挡的下层可以把材质换成半透明 X-Ray 调试材质这类材质一般把 render queue 提前并开启深度写入只用于编辑期排查游戏发布前切回原材质。5.2 AssetBundle 动态加载与 Profiler 验证资源管理和加载实例重点是 AssetBundle 的动态加载与卸载减少初始场景的包袱体积。实例里常见的加载代码如下using UnityEngine; using System.IO; public class AssetLoader : MonoBehaviour { public string bundleName towers; IEnumerator LoadAndInstantiate(string assetName) { // 从 StreamingAssets 路径读取本地 Bundle string path Path.Combine(Application.streamingAssetsPath, bundleName); AssetBundle bundle AssetBundle.LoadFromFile(path); if (bundle null) { Debug.LogError(加载失败: path 请检查 Build 是否生成了对应 Bundle); yield break; } // 加载指定资源并实例化到当前场景 GameObject prefab bundle.LoadAssetGameObject(assetName); Instantiate(prefab, Vector3.zero, Quaternion.identity); // false 表示保留已实例化的对象只释放 Bundle 的原始资源 bundle.Unload(false); } }LoadFromFile在编辑器里路径解析和真机行为一致但要注意 AssetBundle 的依赖 manifest 也必须一并加载否则引用的共享材质会丢失。加载完成后用bundle.Unload(false)保留已实例化的对象只释放资源自身的镜像Unload(true)会连带卸载已实例化对象销毁后所有引用该资产的材质会变成紫粉色这是排查时最常见的现象。验证阶段用 Window Analysis Profiler 打开 CPU 和 Memory 两栏重点看 SetPass calls 是否超过 200以及 GC Alloc 有没有在一帧内出现大量字节分配。四个实例里最容易出问题的是频繁实例化和销毁粒子入池比每次 new 一个粒子系统再销毁要稳。观察 Profiler 里 Spawn 与 Despawn 的波形是否平稳就能确认对象池有没有真正生效。本文还有配套的精品资源点击获取