4 种安装特定版本 Package 的方法

Mon, 22 Dec 2025 11:50:00 +0800

引言

在 Unity 项目的开发生命周期中，工具版本的确定性往往比追求最新更为重要。然而，在实际的工程实践中，开发者面临的需求远比「使用最新版本」复杂得多，包括但不仅限于以下情境：

团队协作对齐：为了确保所有成员的代码表现一致，必须严格锁定所有 Package 的版本号。
老旧项目维护：接手或复现一个两年前的项目时，新版 Package 往往会导致兼容性报错，比如 XRI 2.x 升级到 3.x 的架构断层、API 结构不兼容等。当老项目架构对旧版本 Package 开发依赖严重时，此时回退到旧版本往往是更高效的解决方案。
特定环境复现：跟随特定的技术教程学习时（如 XR Interaction Toolkit、ARFoundation 课程），必须使用与之严格匹配的工具版本，才能得到更好的沉浸式学习体验——版本差异会因为命令路径、界面布局的不一致，而导致学习进程的中断。

对于需要在线安装管理的工具包（比如 Interaction Toolkit、ARFoundation 等），Package Manager 的默认策略通常是推荐当前可用的「最新版」。而安装指定版本的 Package 相对比较有挑战性，因为这些工具包通常不提供离线下载文件，所以我们需要掌握在 Package Manager 中安装特定版本的技巧。

适用范围说明

本文讨论的对象是通过 Package Manager 在线安装的工具包 Package（UPM），并非传统意义上的资源包（.unitypackage）。后续也将会使用 Package 指代前者。

此外，部分第三方厂商（如 PICO、Meta 等）提供的 SDK 通常支持离线安装方式，可直接从官方渠道获取历史版本，故不在本文讨论范围内。

四种方法

方法零：通过详情页历史版本安装

在尝试复杂方法前，可先检查 Unity 原生提供的历史列表，在这里 Unity 会提供几个推荐的稳定版本。

操作步骤（以 Unity 2022 为例）

在 Package Manager 中选择目标 Package。
在右侧详情页点击 Version History 选项卡。
如果目标版本在列表中，直接点击右下角的 Update to x.x.x。

Package Manager on XR技术研习社

4 种安装特定版本 Package 的方法

引言

适用范围说明

四种方法

方法零：通过详情页历史版本安装

操作步骤（以 Unity 2022 为例）