企业官网建设流程全解析

简介：面向 Unity VR 游戏开发与沉浸式体验初学者、独立开发者的无头显实践包，聚焦缺少 HMD 硬件时如何完成项目配置、桌面预览与交互调试，也适合课堂实验和原型验证。压缩包共 2000 个文件、约 895.89MB，含 84 个 C# 脚本、53 个预制体、29 个 Unity 场景、32 个材质、14 个着色器及贴图资源，另有 627 个 md、309 个 txt、167 个 json 等说明与配置文档，覆盖 XR 设置、摄像机绑定、输入模拟和示例场景等模块。已有 737 人学习。其价值在于将无头显环境下的配置思路、可运行示例源码与预制体集中组织，便于对照理解 VR 场景搭建、左右眼视图模拟及输入接口调用；文档和配置清单也有助于排查 SDK、项目设置与资源依赖问题，适合按模块检索并快速复现实验。

1. 没有头显也能把 VR 项目跑起来：先搞清“无头显配置”到底在配什么

很多团队第一次做 Unity VR 开发时，会被“没有头显”卡住：场景搭好了，XR Origin 不动，手柄按键没反应，UI 射线也点不中，最后只能等设备到货。无头显配置不是装一个模拟器就完事，它要同时解决三件事：让 Unity 认为 XR 设备存在、让键鼠输入映射成头显和双手、让示例源码与预制体在没有真实追踪数据时也能走完交互链路。适合正在做原型验证、交互预研、构建前回归测试的从业者，也适合设备数量不够、多人并行开发的小团队。先把边界定清楚，后面配插件和排查才不会翻车。

2. 无头显环境的工程搭建：从 XR 插件到模拟输入的完整链路

2.1 先定运行边界：编辑器模拟、桌面独立构建与真机三段式

无头显开发最怕一种情况：编辑器里看着能跑，构建出来黑屏，插上真机又发现输入绑定全错。我的做法是把运行环境拆成三段，每段只验证一件事。

第一段是编辑器 Play 模式，用 OpenXR 的 Mock Runtime 加 XR Device Simulator，把 XR Origin、双手控制器、抓取和 UI 射线全部跑通。这一段不追求画面好看，只追求交互事件能触发。第二段是桌面独立构建，不启用模拟器，用键盘鼠标或空输入跑一次场景加载，确认构建后没有把编辑器专用对象带进去。第三段才是真机，把输入 Action 从模拟器切到真实设备绑定。

这样拆的好处是排错有边界。黑屏发生在哪一段，就查哪一段的配置，不会把“插件没启用”和“预制体丢引用”混在一起。参数上，我一般把 XR Origin 的 Tracking Origin Mode 设为 Floor，Camera Y Offset 设 0，靠 CharacterController 的 height 和 center 去匹配眼高；模拟器只负责改变 XR Origin 下的相机和控制器姿态，不直接改场景根节点。

提示：无头显配置的目标不是“替代真机”，而是把与硬件无关的逻辑先验证掉。抓取事件、UI 射线、移动碰撞这些逻辑，在模拟器里跑通后，真机阶段只剩输入绑定和性能问题。

2.2 装插件与开 OpenXR：不装头显驱动也能拿到 XR 设备

工程搭建从包管理开始。常见组合是 XR Plugin Management、OpenXR Plugin、XR Interaction Toolkit、Input System，再加 XR Interaction Toolkit 样例里的 XR Device Simulator。安装顺序不用太纠结，但 Input System 装完后编辑器会提示重启或切换 Active Input Handling，这一步不能忽略。Active Input Handling 我一般选 Both，先让旧输入和新输入都能跑，等交互稳定后再收紧到 Input System。

OpenXR 的启用位置在 Project Settings 的 XR Plug-in Management 下。勾选 OpenXR 后，进入 OpenXR 的功能列表，把 Mock Runtime 打开，仅用于编辑器模拟。Mock Runtime 的作用是让 XR 子系统在没有真实设备时也能初始化，避免 XR Origin 拿不到追踪数据。这里有个容易翻车的点：Mock Runtime 是编辑器功能，不要把它当成构建后的运行时设备来源；构建后黑屏，先查这里是不是被误带进构建配置。

下面这段检查脚本可以挂在场景里的空物体上，Play 后看 Console 输出。它不依赖具体头显，只检查 XR Loader、XR Origin 和模拟器对象是否存在。

using UnityEngine; using UnityEngine.XR.Management; using UnityEngine.XR.Interaction.Toolkit; public class XRSetupProbe : MonoBehaviour { [SerializeField] private XROrigin xrOrigin; // 场景中的 XR Origin [SerializeField] private bool requireSimulatorInEditor = true; // 编辑器内是否要求模拟器存在 private void Start() { bool xrActive = XRGeneralSettings.Instance != null && XRGeneralSettings.Instance.Manager != null && XRGeneralSettings.Instance.Manager.activeLoader != null; Debug.Log($"XR Loader Active: {xrActive}"); Debug.Log($"XR Origin: {(xrOrigin ? xrOrigin.name : "missing")}"); var simulator = FindObjectOfType<XRDeviceSimulator>(); Debug.Log($"Simulator In Scene: {simulator != null}"); #if UNITY_EDITOR if (requireSimulatorInEditor && simulator == null) { Debug.LogWarning("编辑器模拟需要 XR Device Simulator，请从 XR Interaction Toolkit 样例导入并拖入场景。"); } #endif } }

逻辑很直接：XRGeneralSettings.Instance.Manager.activeLoader为空，说明 XR 插件没有真正启用，或者 OpenXR 没有勾选；xrOrigin为空，说明场景骨架没挂好；XRDeviceSimulator为空，说明模拟器样例没导入。参数requireSimulatorInEditor只在编辑器里生效，构建后不会因为缺少模拟器报错。这段脚本不解决所有问题，但它能把“到底哪一层没起来”变成 Console 里的一行字，比盲猜省时间。

2.3 导入 XR Device Simulator：把键鼠映射成头显和双手

XR Device Simulator 在 XR Interaction Toolkit 的 Samples 里。导入后不要直接改样例预制体，先在场景里拖一个实例，确认它能控制 XR Origin。模拟器的核心不是“一个脚本”，而是它内部维护了一套模拟设备和一套键盘鼠标输入映射。头显姿态、左手控制器、右手控制器、选择按钮、激活按钮，都在这个组件上。

我一般把模拟器放在场景根节点，和 XR Origin 平级，避免它跟着 XR Origin 移动导致输入坐标系漂移。模拟器 Inspector 里有一组键盘控制绑定，不同样例导入后字段名可能略有差异，以实际 Inspector 为准。常见做法是：用键盘控制头显平移，用鼠标右键拖拽控制视角旋转，用左右 Shift 或空格切换左右手，用鼠标左键触发选择，用键盘按键触发激活。若和编辑器快捷键冲突，先改模拟器绑定，不要改 Unity 编辑器快捷键，否则换一台机器又会乱。

模拟器能跑起来后，先做一次最小验证：Play 模式，选中模拟器，移动头显，看 Main Camera 是否跟着动；按选择键，看手柄预制体上的 XRController 是否显示 select 状态；场景里放一个带 XRGrabInteractable 的立方体，看抓取时 Console 是否打印事件。三步都过，再往下做移动和 UI。

2.4 最小检查表：把“能跑”拆成可复现的六项

无头显环境搭建完后，不要凭感觉说“好了”。我习惯按下面六项过一遍，每项都能在三十秒内确认。

这六项里最容易忽略的是交互层。模拟器能动手，不代表能抓东西；抓不到时先看 XR Grab Interactable 的 Interaction Layer Mask 和手部 Interactor 的 Interaction Layer Mask 是否有交集。另一个常见问题是 XR Origin 的 Camera Offset 被缩放，导致模拟器移动一步，相机实际移动了十倍，UI 射线自然点不中。

3. 用模拟器把交互跑通：移动、抓取、UI 射线的最小示例源码

3.1 场景骨架：XR Origin、双手控制器与模拟器挂载

场景骨架不要一上来就堆模型。先放一个 XR Origin，结构保持为 XR Origin > Camera Offset > Main Camera，左右手控制器挂在 Camera Offset 下。XR Origin 上加 CharacterController，用来做移动碰撞；Main Camera 上加 Tracked Pose Driver，输入绑定由 XR Origin 统一管理。双手控制器用 XR Controller 加 XR Ray Interactor 和 XR Direct Interactor，先只开射线，确认能指到物体后再开直接抓取。

模拟器挂载位置很关键。它不要挂在 XR Origin 下面，否则 XR Origin 移动时模拟器的输入坐标系也跟着动，表现就是“越走越飘”。我一般建一个空物体XRSimulationRig，把 XR Device Simulator 放进去，和 XR Origin 平级。模拟器内部会查找 XR Origin，找不到就自己在 Inspector 里指定。场景层级可以按下面这样组织。

XRSimulationDemo ├─ XR Origin (CharacterController, XROrigin) │ └─ Camera Offset │ ├─ Main Camera (TrackedPoseDriver) │ ├─ LeftHand Controller (XRController, XRRayInteractor, XRDirectInteractor) │ └─ RightHand Controller (XRController, XRRayInteractor, XRDirectInteractor) ├─ XRSimulationRig (XRDeviceSimulator) ├─ GrabbableCube (Rigidbody, BoxCollider, XRGrabInteractable) ├─ TeleportArea (TeleportationArea) └─ WorldSpaceCanvas (Canvas, TrackedDeviceGraphicRaycaster)

这个层级不是唯一解，但它把“追踪源”“输入模拟”“交互对象”分开了。排查时看 XR Origin 有没有动、模拟器有没有输出、物体有没有收到事件，三段独立。

3.2 连续移动与瞬移：Character Controller 驱动 XR Origin

无头显时最容易验证的移动方式是键盘连续移动。下面这段脚本用 Input System 读 WASD，把输入方向投影到相机水平面，再驱动 XR Origin 上的 CharacterController。它不依赖具体手柄，模拟器和真机都能复用同一套移动逻辑。

using UnityEngine; using UnityEngine.InputSystem; using UnityEngine.XR.Interaction.Toolkit; [RequireComponent(typeof(CharacterController))] public class SimpleContinuousMove : MonoBehaviour { [SerializeField] private XROrigin xrOrigin; // 场景中的 XR Origin [SerializeField] private float moveSpeed = 1.5f; // 米/秒，舒适区先设 1.2 到 1.8 [SerializeField] private float gravity = -9.81f; // 重力 [SerializeField] private float stickDeadZone = 0.15f; // 真机摇杆死区，键盘输入不受影响 private CharacterController controller; private Vector3 verticalVelocity; private void Awake() { controller = GetComponent<CharacterController>(); if (xrOrigin == null) xrOrigin = GetComponent<XROrigin>(); } private void Update() { Vector2 input = ReadKeyboardInput(); if (input.sqrMagnitude < stickDeadZone * stickDeadZone) input = Vector2.zero; Vector3 direction = new Vector3(input.x, 0f, input.y); direction = xrOrigin.Camera.transform.TransformDirection(direction); direction.y = 0f; if (direction.sqrMagnitude > 1f) direction.Normalize(); if (controller.isGrounded && verticalVelocity.y < 0f) { verticalVelocity.y = -2f; // 贴地，避免 CharacterController 悬空累积 } verticalVelocity.y += gravity * Time.deltaTime; Vector3 motion = direction * moveSpeed + verticalVelocity; controller.Move(motion * Time.deltaTime); } private Vector2 ReadKeyboardInput() { var keyboard = Keyboard.current; if (keyboard == null) return Vector2.zero; Vector2 input = Vector2.zero; if (keyboard.wKey.isPressed) input.y += 1f; if (keyboard.sKey.isPressed) input.y -= 1f; if (keyboard.dKey.isPressed) input.x += 1f; if (keyboard.aKey.isPressed) input.x -= 1f; return input; } }

moveSpeed是第一个要调的参数。无头显调试时设 1.5 左右，接真机后如果晕动明显，降到 1.2 以下，或者改用瞬移。gravity保持 -9.81，除非场景是太空或水下。stickDeadZone目前只对摇杆输入有意义，键盘输入是离散值，不会落在死区里。CharacterController的 height 和 center 要匹配相机眼高，常见做法是 height 1.6、center 0.8、radius 0.2，但相机在 Camera Offset 下的局部高度也要一起看，不然会出现“人眼在碰撞体头顶”的玄学。

瞬移不要和连续移动挤在同一个脚本里。用一个 Teleportation Area 加 XR Ray Interactor 的 Teleport 模式，把瞬移区域单独放一层，Interaction Layer Mask 只勾选 Teleport 层。这样连续移动时不会误触瞬移，排查也清楚。

3.3 抓取与投掷：XR Grab Interactable 的事件链

抓取跑不通时，先不要怀疑模拟器。XR Grab Interactable 的依赖很明确：物体要有 Rigidbody 和 Collider，手部要有 XR Direct Interactor 或 XR Ray Interactor，双方 Interaction Layer Mask 要有交集。下面这段事件日志脚本挂在可抓取物上，能把 selectEntered、selectExited、activated 三个关键事件打到 Console。

using UnityEngine; using UnityEngine.XR.Interaction.Toolkit; [RequireComponent(typeof(XRGrabInteractable))] public class GrabEventLogger : MonoBehaviour { [SerializeField] private bool logActivated = true; // 是否记录扳机激活 private XRGrabInteractable grab; private void Awake() { grab = GetComponent<XRGrabInteractable>(); grab.selectEntered.AddListener(OnGrabbed); grab.selectExited.AddListener(OnReleased); if (logActivated) grab.activated.AddListener(OnActivated); } private void OnGrabbed(SelectEnterEventArgs args) { Debug.Log($"抓取者: {args.interactorObject.transform.name} 物体: {name}"); } private void OnReleased(SelectExitEventArgs args) { Debug.Log($"释放物体: {name}"); } private void OnActivated(ActivateEventArgs args) { Debug.Log($"扳机按下: {name}"); } }

事件能打印，说明输入链路和交互层至少通了。接下来调 XRGrabInteractable 的参数：Movement Type 先用 Instantaneous，抓取位置干脆，适合验证；Throw On Detach 打开后可以测投掷，但无头显时模拟器的速度采样不准，投掷距离会偏，先关掉。Attach Transform 建议单独建一个子物体，放在物体几何中心偏下的位置，抓起来不会挡住视线。Mass 先设 1，太小会抖，太大会让投掷没有手感。

注意：XRGrabInteractable 的 Rigidbody 不要勾 Is Kinematic，Collider 不要勾 Is Trigger，否则抓取事件可能触发但物体会穿模。抓取物和场景静态碰撞体之间保持默认碰撞矩阵，不要为了省性能把整层关掉。

3.4 UI 射线：Tracked Device Graphic Raycaster 的落点配置

UI 射线点不中，十有八九是 Canvas 还是 Screen Space Overlay，或者 Canvas 上没有 Tracked Device Graphic Raycaster。世界空间 UI 的配置顺序是：Canvas 设 World Space，挂 Tracked Device Graphic Raycaster，指定 Event Camera 为 XR Origin 下的 Main Camera，再把 Canvas 的 Layer 加进手部 XR Ray Interactor 的 Raycast Mask。

下面这段脚本在运行时检查 Canvas 配置，适合挂在 UI 根节点上，Play 后看 Console。

using UnityEngine; using UnityEngine.XR.Interaction.Toolkit.UI; [RequireComponent(typeof(Canvas))] public class WorldSpaceUICheck : MonoBehaviour { [SerializeField] private Camera xrCamera; // 指定 XR Origin 下的 Main Camera [SerializeField] private bool forceWorldSpace = true; // 运行时强制世界空间 private void Awake() { var canvas = GetComponent<Canvas>(); if (forceWorldSpace) canvas.renderMode = RenderMode.WorldSpace; if (canvas.worldCamera == null) canvas.worldCamera = xrCamera; var raycaster = GetComponent<TrackedDeviceGraphicRaycaster>(); if (raycaster == null) { raycaster = gameObject.AddComponent<TrackedDeviceGraphicRaycaster>(); } Debug.Log($"Canvas: {name} Mode: {canvas.renderMode} Camera: {(canvas.worldCamera ? canvas.worldCamera.name : "null")}"); } }

forceWorldSpace只建议在原型阶段打开，正式工程里还是手动配置，避免运行时改渲染模式导致材质重建。xrCamera必须指向 XR Origin 下的相机，不要指向场景里另一个普通相机，否则 UI 射线会按普通屏幕坐标算，模拟器里看着能点，真机就偏。TrackedDeviceGraphicRaycaster会自动添加，但 UI 层和手部 Raycast Mask 的匹配仍然要手动确认。

4. 预制体怎么拆：手柄、射线、可抓取物与场景装配

4.1 预制体分层：把“追踪源”和“表现层”分开

无头显配置最容易做坏的地方，是把模拟器、手柄模型、交互器全塞进一个预制体。表现层一改，追踪源就丢；模拟器一换，手柄引用全断。我的拆法是三层：追踪源层放 XR Origin 和左右手 XR Controller；交互层放 XR Ray Interactor、XR Direct Interactor、XR Interaction Group；表现层放手柄模型、LineRenderer、抓取高亮。三层之间用 Transform 父子关系和 SerializeField 引用连接，不互相硬编码查找。

这样拆以后，左手柄和右手柄可以是同一个基础预制体的 Variant，只覆盖输入 Action、Attach Transform 位置和 LineRenderer 颜色。模拟器只依赖 XR Controller，不关心手柄模型长什么样。抓取物也是独立预制体，只依赖 Rigidbody、Collider、XRGrabInteractable，不依赖具体场景。

这张表不是让你一次全建，而是让你知道每个预制体的责任边界。排查时先看责任边界有没有被破坏，比如手柄预制体里突然多了一个 CharacterController，移动就会和 XR Origin 打架。

4.2 左手柄预制体：Ray Interactor 与 Direct Interactor 并存

手柄预制体上同时放 XR Ray Interactor 和 XR Direct Interactor 很常见，一个负责远距离点选和 UI，一个负责近距离抓取。两者同时启用会抢事件，表现是“明明想抓近处物体，射线却先选中了远处 UI”。解决方式不是关掉一个，而是用 XR Interaction Group 管理优先级：Direct Interactor 优先级高，Ray Interactor 优先级低；没有近处目标时，射线才接管。

参数上，Ray Interactor 的 Max Raycast Distance 先设 10，Raycast Mask 包含 Default 和 UI 层；Direct Interactor 的 Sphere Collider 勾 Is Trigger，Radius 设 0.08 到 0.12，Interaction Layer Mask 只勾 Grab 层。Attach Transform 放在手柄前端偏下，抓取时物体不会贴着脸。LineRenderer 的材质用无光照半透明，宽度 0.005 到 0.01，太粗会挡 UI。

如果不用 XR Interaction Group，也可以在selectEntered里临时禁用另一个 Interactor，但这是后悔药，不是长期方案。多人协作时，别人不知道你加了这个逻辑，改预制体就会翻车。

4.3 可抓取物预制体：Rigidbody、Collider、XRGrabInteractable 的顺序

可抓取物预制体的组件顺序不影响运行，但影响排查。我一般按 Rigidbody、Collider、XRGrabInteractable、GrabEventLogger 的顺序加。Rigidbody 的 Mass 设 0.5 到 1，Drag 0.1，Angular Drag 0.05，Interpolate 选 Interpolate，Collision Detection 选 Continuous Speculative。Collider 不要勾 Is Trigger，尺寸比模型略小一点，抓取时不容易和场景边缘卡住。

XRGrabInteractable 的 Movement Type 先用 Instantaneous，稳定后再试 Kinematic。Use Dynamic Attach 打开后，抓取点会根据手部位姿动态计算，手感更自然，但无头显模拟器的姿态采样频率低，可能出现抓取瞬间跳动。Attach Ease In Time 设 0.1 到 0.15，太长会感觉延迟。Throw On Detach 在模拟器阶段建议关闭，等真机再开。

提示：抓取物预制体不要直接放场景里改参数。场景里改完忘了 Apply，下一次打开又回到旧值，这是血泪经验。所有可复用参数都在预制体资产上改，场景只做摆放和少量覆盖。

4.4 用 Prefab Variant 管理左右手与不同交互配置

左右手预制体不要复制两份。建一个HandController_Base，里面放 XRController、XR Ray Interactor、XR Direct Interactor、XR Interaction Group，然后创建两个 Variant：HandController_Left和HandController_Right。Variant 只覆盖输入 Action 引用、Attach Transform 的局部位置、LineRenderer 颜色和手部模型。这样基础交互参数一改，左右手同时生效，不会出现左手能抓、右手不能抓的诡异问题。

Variant 的覆盖项越少越好。如果发现某个 Variant 覆盖了半个预制体，说明基础预制体拆得不对，应该把差异部分再拆成子预制体。场景装配时，XR Origin 放场景根节点，左右手 Variant 拖到 Camera Offset 下，模拟器放同级空物体，抓取物和 UI 按层摆放。这样一套示例源码和预制体就能在无头显环境里反复装配，不依赖具体场景。

5. 避坑与排查：黑屏、追踪丢失、输入无响应、构建后失效

5.1 现象：Play 模式黑屏，或者相机完全不动

现象很直观：点 Play 后 Game 视图黑屏，或者画面有但移动鼠标、按键盘，XR Origin 完全不动。原因通常有两个：OpenXR 没有真正启用 loader，或者 Mock Runtime 没打开。XR Origin 拿不到 XR 设备时，Tracked Pose Driver 不会更新相机姿态，模拟器也没有可控制的设备，看起来就是“死了”。

解决顺序是：先看 Console 有没有 XR 初始化报错；再打开 Project Settings 的 XR Plug-in Management，确认 OpenXR 勾选；然后进 OpenXR 功能列表，确认 Mock Runtime 打开；最后看场景里的 XRSetupProbe 输出，XR Loader Active 是否为 true。如果 loader 为 false，重启编辑器再试，Input System 切换后不重启经常出现这种假死。

另一个黑屏原因是相机被放在 Canvas 或模型后面，Clipping Near 设得太大。XR 相机 Near 一般设 0.05 到 0.1，太大会把近处手柄切掉，看起来像黑屏。还有一种情况是 XR Origin 的 Scale 被设成 0，模拟器怎么动都没画面，检查 Transform 的 Scale 是不是 1。

5.2 现象：手柄按键无响应，抓取事件不触发

模拟器能转头，但按选择键没反应，抓取物也不亮。先分清是输入没到 Interactor，还是 Interactor 没选中物体。打开 XR Controller 的 Inspector，Play 后看它有没有显示 select 状态；如果没有，查模拟器的键盘映射和 Input System 的 Active Input Handling。如果有 select 状态但物体没反应，查 Interaction Layer Mask 和 Collider。

最常见的翻车点是 Interaction Layer Mask 互相排除。手部 Interactor 只勾了 Grab 层，抓取物却在 Default 层；或者抓取物勾了 Grab 层，但 Rigidbody 被设成 Kinematic。另一种情况是 XRGrabInteractable 的 Colliders 列表为空，组件不知道用哪个 Collider 做抓取检测，事件自然不触发。

解决时按这个顺序：手部 Interactor 的 Interaction Layer Mask 是否包含抓取物所在层；抓取物是否有 Rigidbody 和非 Trigger Collider；XRGrabInteractable 的 Colliders 是否自动填了；模拟器选择键是否真的按下。四步里总有一部能定位。不要一上来就重装包，多数问题在场景配置。

5.3 现象：构建后模拟器消失，头显追踪丢失

编辑器里跑得好好的，构建后模拟器对象不见了，XR Origin 也不追踪。原因很简单：XR Device Simulator 是编辑器样例，构建时不应该作为运行时输入源；Mock Runtime 也不应该被当成构建后的设备。构建后需要真实 XR 运行时，或者至少一个可用的 XR loader。无头显阶段构建，本来就不是为了跑交互，而是为了验证场景加载和资源引用。

解决方式是给模拟器对象加编辑器限定，构建前用脚本或手动禁用。更稳妥的做法是把模拟器放在单独的EditorOnly层，构建时通过BuildPlayerProcessor剔除，但原型阶段手动禁用就够了。构建后黑屏还要检查 Player Settings 里有没有启用 XR 相关选项，以及场景列表里有没有把模拟器场景一起打进去。

注意：不要把 Mock Runtime 当作构建后的保底方案。它解决的是编辑器内无设备初始化，不是运行时设备模拟。构建后追踪丢失，先查真实 XR 运行时和输入绑定，不要继续在模拟器配置里打转。

5.4 现象：UI 射线点不中，抓取物抖动或穿模

UI 射线点不中，先看 Canvas 是不是 World Space，再看有没有 Tracked Device Graphic Raycaster，最后看 Event Camera 是不是 XR 相机。三者缺一个，射线就会按屏幕坐标算，模拟器里看着能点，实际上点的是 Game 视图中心。抓取物抖动通常是 Rigidbody 的 Mass 太小、Collider 太大，或者 XR Grab Interactable 的 Movement Type 设成了 Velocity Tracking 但模拟器速度采样不稳。

解决抖动时，先把 Movement Type 改 Instantaneous，Mass 调到 0.5 以上，Collider 缩小 10%，Collision Detection 改 Continuous Speculative。穿模则查抓取物的 Collider 和场景碰撞体是否在同一碰撞矩阵，以及 CharacterController 的 skin width 是否太小。UI 射线还有一个隐蔽问题：Canvas 的 Layer 没加进 Ray Interactor 的 Raycast Mask，射线程明明打到了 UI，但 Filter 把它过滤掉了。

我自己的排查习惯是：先看 Console 事件，再看 Inspector 状态，最后才改参数。事件没触发，改参数是瞎猜；事件触发了但表现不对，才是参数问题。

6. 进阶验证：用无头显做交互回归测试与性能基线

无头显链路跑通后，别急着接真机。它最大的价值是回归测试：每次改预制体、换输入绑定、调交互层，都能在编辑器里跑一遍固定用例。我的做法是给示例场景加一个 PlayMode 测试，断言 XR Origin 存在、抓取物存在、抓取事件能被触发。测试不依赖头显，只依赖模拟器和场景对象。

using NUnit.Framework; using UnityEngine; using UnityEngine.TestTools; using System.Collections; using UnityEngine.XR.Interaction.Toolkit; public class XRGrabSmokeTest { [UnityTest] public IEnumerator Scene_HasOriginAndGrabbable() { UnityEngine.SceneManagement.SceneManager.LoadScene("XRSimulationDemo"); yield return null; Assert.IsNotNull(Object.FindObjectOfType<XROrigin>(), "场景缺少 XR Origin"); var grab = Object.FindObjectOfType<XRGrabInteractable>(); Assert.IsNotNull(grab, "场景缺少可抓取物"); Assert.IsNotNull(grab.GetComponent<Rigidbody>(), "可抓取物缺少 Rigidbody"); bool grabbed = false; grab.selectEntered.AddListener(_ => grabbed = true); yield return null; Assert.IsFalse(grabbed, "未操作时不应触发抓取"); } }

这段测试只做冒烟断言，不模拟真实按键。更完整的做法是用 Input System 的测试夹具模拟按键，再断言grabbed变 true，但那是另一层工程。先把冒烟测试跑通，至少能防止“改预制体把 XR Origin 改丢”这种低级翻车。

性能基线看三个数就够：主线程每帧耗时、Batches、GC Alloc。无头显环境下没有真实头显的渲染压力，但交互逻辑的 GC 会暴露出来。抓取事件里不要每帧new数组，不要用 LINQ 查 Interactor，LineRenderer 的材质不要运行时实例化。每次改完交互脚本，跑三十秒模拟器移动加抓取，看 Profiler 里 GC Alloc 是否稳定在 0 B/帧附近。

我现在的习惯是：新场景先过无头显六项检查，再跑一遍冒烟测试，最后才接真机。这个顺序听起来慢，实际省掉了大量“以为是头显问题”的排查时间。希望帮到你。

本文还有配套的精品资源，点击获取