只纳入实际可触达的变更

以下示例与示意结果由本站编写，用于说明方法，不是模型实测结果。

使用场景

框架教学升级v1→v2包含API alpha参数变更和beta移除。项目静态使用alpha，插件配置可能动态加载beta；不能把全局迁移清单直接写成项目已确认缺陷。

具体做法

固定当前与目标版本及迁移材料。列实际导入、调用方、配置、生成代码和动态加载入口，与版本差异求交集。对可达变化跟到本地行为及所需检查；未使用的变化只作不适用候选，动态未知记录覆盖缺口。运行受影响契约样例，区分建议风险与确认错误。

反例

把v2所有破坏性变化都列为本项目错误，或因为没看到beta的import就说完全无影响。

改进写法

审查alpha调用的实际参数与v2契约，并检查插件配置中的beta加载。每项记录版本变化、本地路径和检查结果；无法观察动态入口则标待核，不把全局条目当已复现缺陷。未适用项说明判断范围。

为什么这样改

可达路径把迁移文档与项目行为连接，使建议集中在实际接触到的变化。动态缺口保持可见，避免静态扫描给出虚假的完全覆盖。

如何验证

教学结果至少包含alpha本地调用检查；beta若配置启用则进入适用检查，若配置未知则待核。仅没有import不能结案。移除alpha调用后需重新判断适用范围，而非保留过期缺陷。

适用边界

此条目没有已确认冻结来源，v1/v2与API名称是教学构造。反射、插件、代码生成和运行配置可超出静态可达性。真实升级需核实目标版本契约和实际环境，不能从版本号直接推兼容。