核心概念

已弃用

/ DEP-rih-kay-tid /

当某样东西被标记为「已弃用(deprecated)」,意思是官方正式不建议你再用它,它已经在退场的路上了。眼下它还能正常工作——今天不会坏——但维护者其实在明白地告诉你:别再用这个了,已经有更好的替代品,而且总有一天它会被彻底移除。

可以把它理解成功能被请出门前那句客气的「最后通知」。你通常会以「弃用警告(deprecation warning)」的形式遇到它,出现在控制台或文档里,而且往往会直接告诉你该改用什么。

明智的做法是:趁它还只是个警告时就动手处理。已弃用的代码是在「借来的时间」里苟活——现在就按自己的节奏迁移到替代方案,别等到将来某次升级真把它删掉时手忙脚乱。

DeprecationWarning: 'foo()' is deprecated and
will be removed in v3.0. Use 'bar()' instead.

一条典型的弃用警告——注意,它连替代方案都直接告诉你了。

「已弃用」是「不建议用」,不是「已删除」——这个词源自拉丁语,本意是「祈求避开」。

又称
deprecationdeprecation warningsunsetlegacy