vrc-get包管理实战:outdated、upgrade、downgrade命令详解,让VRChat依赖升级无忧

原创2026-11-12 20:38:152,161 阅读

vrc-get包管理实战:outdated、upgrade、downgrade命令详解,让VRChat依赖升级无忧

vrc-get 是开源的 VRChat 包管理器(VRChat Package Manager)命令行客户端,本文详解其中最实用的三个命令:vrc-get outdated 查看过期包、vrc-get upgrade 升级依赖、vrc-get downgrade 回退版本,帮助新手快速掌握 VRChat 依赖升级与降级的完整流程,让项目依赖管理无忧。

一、认识 vrc-get:VRChat 依赖管理的瑞士军刀

vrc-get 是社区开发的开源工具,相当于官方 VRChat Creator Companion(VCC)中"包管理"功能的命令行版本,支持 Windows、Linux 和 macOS,并提供了比官方更多样的能力。核心能力包括:

  • 安装/卸载:vrc-get install(别名 i)、vrc-get remove(别名 rm)
  • 依赖维护:vrc-get outdated、vrc-get upgrade、vrc-get downgrade、vrc-get reinstall
  • 仓库管理:vrc-get repo add/remove/list/cleanup 等子命令

它还能自动识别当前目录或父目录中的 Unity 项目,省去手动指定路径的麻烦。更多命令列表可参考 vrc-get/README.md。

ALCOM 图形界面中的 VRChat 包管理页面,显示已安装版本与可升级的最新版本

💡 除了命令行,vrc-get 还有图形界面版 ALCOM(见 vrc-get-gui/),可以在界面里"一键全部更新(最新/稳定版)",适合不想敲命令的同学。

二、快速上手:30 秒检查哪些依赖过期了

在项目目录下执行:

vrc-get outdated

它会遍历项目中所有已锁定(locked)的包,对照仓库中与你 Unity 版本兼容的最新版本,逐条输出:

com.vrchat.avatars: installed: 3.7.2, found: 3.7.5
net.r54a.tex-trans-tool: installed: 0.8.10, found: 0.8.15

输出为空的说明依赖全部是最新的 🎉

这个命令的判定逻辑在源码 vrc-get/src/commands.rs 中实现:只有当仓库中的最新版本大于当前锁定版本时才会被列入清单。它还会自动排除"被其他包的依赖范围限制住、升级会破坏依赖约束"的包,因此列出的都是可以放心升级的项。

几个常用参数:

参数 作用
-p <路径> / --project 指定项目目录(默认自动向上查找)
--prerelease 把预发布版本(beta/rc)也纳入比较
--json-format 1 以 JSON 输出,方便脚本或 CI 集成
--offline / --no-update 只用本地仓库缓存,不联网更新

三、升级依赖:vrc-get upgrade 的正确姿势

upgrade 是升级已安装包的主力命令,分为两种用法:

3.1 升级单个包

# 升级到最新兼容版本
vrc-get upgrade com.vrchat.base

# 升级到指定版本
vrc-get upgrade com.vrchat.base 3.7.4

3.2 全量升级

不带包名时,所有已锁定的包都会被尝试升级到最新兼容版本:

vrc-get upgrade

全量升级时,vrc-get 会先打印一份完整的变更清单(新安装哪些包、新增哪些依赖、移除哪些旧资产、存在哪些冲突),确认无误后输入 y 才真正执行;加上 -y/--yes 可跳过确认,适合自动化脚本。

upgrade 与 install 的关键区别(这一点很多人会混淆):

  • vrc-get install <pkg>:把包加入项目依赖(vpm-manifest.json 的 dependencies),并连带升级;
  • vrc-get upgrade <pkg>:只升级已锁定的版本,不会把新包添加进依赖列表。

相关实现在 vrc-get/src/commands.rs,升级完成后会逐条打印 upgraded xxx to 3.7.5 这样的结果。

⚠️ 注意:升级/降级涉及删除遗留资产或存在包冲突时,vrc-get 一定会弹出确认提示,这是防误删的安全设计,不是 Bug。

四、回退版本:vrc-get downgrade 一键降级

新版包出现 Bug、API 不兼容时,降级是最好的救急手段。downgrade 必须同时指定包名和目标版本(它于 vrc-get 1.7.0 引入,见 vrc-get/CHANGELOG.md):

# 语法:vrc-get downgrade <包名> <目标版本>
vrc-get downgrade com.vrchat.avatars 3.7.2

它会从仓库中找到你指定的历史版本并重新安装,成功后打印:

downgraded com.vrchat.avatars to 3.7.2

使用技巧:

  • 不确定目标版本有哪些?先用 vrc-get search <关键词> 或 vrc-get repo packages <仓库名> 查看该包在各仓库中的版本列表;
  • 搭配 --prerelease 可以精确命中 beta 版本;
  • 降级完成后,建议再跑一次 vrc-get outdated,确认没有引入新的"过期"提示。

五、进阶:常用选项与排错清单

三个命令共享一组环境选项(定义见 EnvArgs):

选项 说明
--prerelease 允许预发布版本参与版本选择
-p、--project 指定 Unity 项目目录,默认从当前目录向上查找
--offline 完全离线,只用本地缓存(隐含 --no-update)
--no-update 联网但跳过仓库缓存更新,速度更快
-y、--yes 跳过交互确认(自动化场景使用)

常见问题排查:

  1. 提示 no matching package not found:包名写错或仓库缓存过期,先执行 vrc-get update 刷新缓存再试;
  2. 升级卡住/报网络错误:加 --no-update 复用本地缓存,或检查 VPN 代理;
  3. 想恢复到改动前的状态:升级前建议备份 Packages/ 目录和 vpm-manifest.json,或用 ALCOM 的项目备份功能;
  4. 担心破坏项目:所有破坏性变更都会先列出清单并要求确认,回答 n 即可安全取消。

ALCOM 项目列表页面,集中管理多个 VRChat Unity 项目并可快速打开或备份

六、不想敲命令?用 ALCOM 图形界面代替

如果你管理多个 VRChat 项目,推荐搭配 vrc-get-gui/ 提供的 ALCOM 使用:

  • 项目总览:侧边栏"プロジェクト"集中列出所有项目,支持一键打开 Unity、备份项目;
  • 包管理:进入项目的"パッケージ管理"页,每个包都会显示已安装版本与绿色高亮的最新可升级版本,勾选后点"全部更新"即可,等效于 vrc-get upgrade;
  • 仓库管理:支持从列表文件一键导入仓库,格式说明见 docs/repository-list-file-format.md。

七、总结:三条命令搞定依赖生命周期

需求 命令 一句话说明
体检:哪些包过期了 vrc-get outdated 只读检查,不修改任何文件
升级:拉齐到最新版 vrc-get upgrade [包名] [版本] 可单包、可全量,不新增依赖
降级:回退到旧版本 vrc-get downgrade 包名 版本 精确指定目标版本

建议把 outdated → upgrade → (出问题)downgrade 作为 VRChat 项目的日常维护节奏:每次进 Unity 前花 10 秒跑一次 vrc-get outdated,有新版再选择性升级,遇到兼容性事故立即用 vrc-get downgrade 回滚,依赖管理从此有恃无恐 🚀

登录后查看全文
vrc-get