Unity XR项目GameObject->XR菜单选项缺失问题排查

核心诱因与遗漏配置项 #

• XR依赖包安装不完整
  打开Window -> Package Manager检查项目包列表：绝大多数XR菜单选项（交互器、传送区域、可交互对象、AR基础组件等）都由XR Interaction Toolkit包提供，仅安装XR Plugin Management时，菜单只会残留极少量基础选项。
  同时确认XR Core Utilities依赖包已正常安装，Unity 2021+版本如果缺失这个包，XR Toolkit的Editor脚本无法正常注册，会直接导致菜单加载不全。安装包过程中不要跳过Editor脚本、必要资源的导入步骤，相关脚本缺失会直接让菜单项被系统过滤。
• 包版本兼容/冲突问题
  如果你安装的是1.x及更早版本的XR Interaction Toolkit，在Unity 2022+版本上存在菜单注册兼容bug，升级到2.3以上的稳定正式版即可恢复。
  如果项目导入过旧版第三方VR SDK（比如2.0前的SteamVR Plugin、30版本前的Oculus Integration），这些包的旧菜单逻辑会和官方XR Toolkit冲突，临时移除冲突包后重启编辑器即可验证问题。
• 编辑器缓存/配置异常
  关闭编辑器后删除项目目录下Library/ScriptAssemblies、Library/EditorOnly两个文件夹，重启编辑器让所有Editor脚本重新编译、重建菜单注册缓存——脚本编译失败、缓存损坏是菜单选项莫名丢失的高频原因。
  另外检查编辑器是否切到了Debug模式、自定义布局，部分自定义布局会过滤非高频菜单项，切回Default默认布局再查看菜单即可。
• 基础XR开关未开启
  打开Edit -> Project Settings -> XR Plugin Management，确认当前目标构建平台（Windows/Android/Quest等）下对应的运行时插件（OpenXR、Oculus、Mock HMD等）已经勾选启用，未启用任何XR运行时的情况下，编辑器会自动隐藏大部分XR相关编辑菜单。
  确认项目已启用新输入系统：XR Interaction Toolkit 2.x版本依赖Input System包，在Player Settings里把Active Input Handling改成Input System Package (New)或者Both，仅启用旧Input Manager时部分XR菜单项不会显示。

注意：场景内完成XR Rig配置、将Main Camera挂载到XR Rig节点下的操作，和XR菜单是否显示完全无关，菜单项显隐只和包导入状态、编辑器全局配置相关，不需要调整场景节点来修复这个问题。

内容的提问来源于stack exchange，提问作者Abhilash K