CUDA 弃用项怎么看：把发行说明转成迁移窗口 NEWS DETAIL

CUDA 发行说明中的弃用表示某项能力仍可能存在，但不应再作为长期依赖；团队应立即盘点受影响代码、框架和构建链，安排替代方案与测试窗口。等到后续版本移除后再处理，会把代码修改、驱动升级和生产回退集中到同一次高风险变更。

适用条件与判断边界

适用于维护自定义 CUDA 代码、算子、编译工具链或长期镜像的团队。需要同时关注 Toolkit、编译器、运行库、架构支持、样例和已知问题。预编译框架用户也应查看框架发布说明，因为其内部可能依赖被弃用接口。是否受影响必须以实际版本和构建参数为准。

实施与选型方法

每次评审发行说明时，把新增、行为变化、弃用、移除和已知限制分别登记，搜索代码、镜像和流水线中的对应依赖。为弃用项确定替代接口、最晚迁移版本、测试责任人和回退镜像。先在双版本 CI 中构建并运行单元、数值一致性和性能回归，再逐步迁移开发与生产。

主要风险与控制方式

只依赖编译警告可能漏掉动态加载和第三方组件，直接把警告关闭会掩盖风险。替代接口可能改变数值、精度、内存或性能行为，不能只确认编译通过。发行说明会随补丁更新，保存离线摘要时也要记录访问日期和目标版本。

如何核验结果

1. 从代码、容器、构建日志和依赖清单四处搜索弃用项，确认没有隐藏调用。
2. 在当前与目标 CUDA 版本运行同一测试集，比较结果、错误、资源和性能分布。
3. 验证旧镜像、驱动和数据仍可恢复，并确认迁移后不再加载被弃用库。

下一步行动

建立季度 CUDA 依赖评审，把弃用项按影响和移除时间进入技术债计划。新代码禁止继续引入已弃用接口，现有迁移在目标版本成为生产默认前完成。

核对具体版本与功能边界时，可查看CUDA Toolkit Release Notes，并以目标版本页面为准。