知仓学习社
概念
不随版本变化
版本与依赖：为什么「昨天还能跑」
上游一变，昨天跑通的东西今天就报错。能防的只有一件事：把版本记下来。
「昨天还能跑，今天报错了」几乎总是同一个原因：中间有东西变了，而你没记下它原来是什么版本。
为什么会变
- 主程序更新了，节点行为或参数随之改变
- 扩展更新了，作者的接口改了，或者把功能挪到了别处
- 依赖库更新了，版本之间不兼容（尤其是显卡计算相关的库）
这些更新本身是好事，但它们会让没有版本标注的教程与工作流突然失效。所以问题不在更新，而在没记版本。
三类常见变化
| 变化 | 表现 | 应对 |
|---|---|---|
| 节点改名或移除 | 工作流加载时提示缺节点、节点显示红色 | 按功能找替代节点，或回退到能用的版本 |
| 参数改名或改范围 | 参数为空、报错、或者结果明显异常 | 对照节点导出的参数信息确认新参数 |
| 依赖不兼容 | 启动时报导入错误，或功能互相打架 | 逐个禁用扩展定位，再单独处理那一个 |
怎么自保
- 记录当前版本：主程序、扩展、主要依赖，各记一个版本号。升级前先记，升级后没法回看。
- 改动前留一份能跑的状态：至少要记住「哪些东西是一起升级的」，回退时一起退。
- 升级后先跑一个最小工作流：确认基础流程没问题，再去跑复杂工作流。这样出错范围小，好定位。
- 把结论写进笔记：写清「哪个版本 + 什么现象 + 怎么解决」。下次遇到同样现象直接查，不用重新试。