第1章 Unity脚本概览

问题：怎样证明自己复现的是第1章，而不是一个同名教程？

先预测：如果删掉原章标题、命名实例和系统边界，只留一段能运行的C#代码，另一位读者还能反推出本章吗？不能。先让脚本在Start建立初始状态，在Update读取输入并用帧时间驱动物体，再用触发器把吃金币和终点连接为3D滚球跑酷。每个回调只承担一种时序责任。

原书边界与目录单元

本页严格对应2021年版目录中的以下单元。现代API和工程补充可以解决版本差异，但不能替代这些原目录位置：

控制物体的运动
Start和Update事件
修改物体位置
读取和处理输入
实例：实现一个移动的小球
触发器事件
实例：吃金币
制作第一个游戏：3D滚球跑酷
游戏设计
功能实现
游戏机制
完成和完善游戏

详细章目采用得到电子书目录；作者、ISBN与出版社信息由教材采选系统交叉核对。本站重新组织讲解、代码、实验和证据，不逐字复制原文。导读和总复习不重复计入13个正文章。

核心模型与行为不变量

先让脚本在Start建立初始状态，在Update读取输入并用帧时间驱动物体，再用触发器把吃金币和终点连接为3D滚球跑酷。每个回调只承担一种时序责任。

先写功能切片：输入来自哪里，哪个对象拥有状态，在哪个Unity回调更新，调用哪个引擎系统，输出由谁消费，失败时第一条信号是什么。脚本、Inspector引用和场景对象都必须能回到同一个切片编号。

相同输入在不同帧率下得到一致速度，金币只结算一次，成功和失败状态互斥。这条不变量要在正常、边界和失败三组输入下成立。最终画面正确但中间所有权、时序或资源生命周期错误，仍不能签发。

五个核心术语

它必须落到第1章的输入、状态、输出与失败信号，不能只作为名词记忆。

术语连成模型后，再记录对象的创建、启用、禁用、销毁和场景切换行为。Unity回调不是任意函数名，而是引擎调度合同；在错误阶段读取输入、推进物理或释放资源，会产生偶发且难以回放的故障。

从输入到结果的数据链

本章主链是：读取输入 → 计算位移 → 移动小球 → 进入触发器 → 更新金币 → 判定终点。每个节点保存切片ID、帧号、对象ID和状态版本。表现系统只能呈现玩法事实，资源与数据系统必须通过租约或快照管理生命周期。

void Update()
{
    Vector2 input = new(Input.GetAxisRaw("Horizontal"), Input.GetAxisRaw("Vertical"));
    Vector3 delta = new(input.x, 0f, input.y);
    transform.position += speed * Time.deltaTime * delta.normalized;
}

旧输入API、Text、AssetBundle或LitJSON可以迁移到Input System、TextMeshPro、Addressables或System.Text.Json，但迁移账本必须写明原书问题、替代实现、保留不变量和对照证据。

三步复现与中间检查

两个必须主动制造的失败样本

当前Unity迁移表

原书对象	当前实现	必须保留的证据
旧输入、UI或资源API	当前官方包或兼容层	原案例输入、状态和结果对照
MonoBehaviour回调	明确时钟与状态所有者的组件	Awake到Destroy的顺序日志
场景公开引用	SerializeField、稳定ID或运行时注入	缺失引用检查和场景重载回放
手工创建销毁	仅在证据支持时使用对象池或租约	创建、复位、唯一释放和峰值数据

现代迁移不能把原书内容改写为通用最佳实践清单。每章首先复现其具体系统和实例，再补充版本差异、性能风险和可测试接口。

证据包与自动检查

每次运行至少保存原章、案例、构建号、输入序列、状态版本、首个失败信号、截图或日志哈希以及修复后同输入回放。跨系统案例还要保存对象和资源的创建释放记录。

{
  "chapter": "第1章",
  "unit": "控制物体的运动",
  "flow": [
    "读取输入",
    "计算位移",
    "移动小球",
    "进入触发器",
    "更新金币",
    "判定终点"
  ],
  "normal": true,
  "boundary": true,
  "failureReplay": true
}

PASS chapter=第1章 ownership=true timing=true result=true
PASS invariant=相同输入在不同帧率下得到一致速度，金币只结算一次，成功和失败状态互斥。
REJECT missing-unit | duplicate-event | stale-reference | premature-release