vrc-get包管理实战:outdated、upgrade、downgrade命令详解,让VRChat依赖升级无忧
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。
💡 除了命令行,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 |
跳过交互确认(自动化场景使用) |
常见问题排查:
- 提示
no matching package not found:包名写错或仓库缓存过期,先执行vrc-get update刷新缓存再试; - 升级卡住/报网络错误:加
--no-update复用本地缓存,或检查 VPN 代理; - 想恢复到改动前的状态:升级前建议备份
Packages/目录和vpm-manifest.json,或用 ALCOM 的项目备份功能; - 担心破坏项目:所有破坏性变更都会先列出清单并要求确认,回答
n即可安全取消。
六、不想敲命令?用 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 回滚,依赖管理从此有恃无恐 🚀

