核心概念

已棄用

/ DEP-rih-kay-tid /

當某樣東西被標記為「已棄用(deprecated)」,意思是官方正式不建議你再用它,它已經在退場的路上了。眼下它還能正常運作——今天不會壞——但維護者其實在明白地告訴你:別再用這個了,已經有更好的替代品,而且總有一天它會被徹底移除。

可以把它理解成功能被請出門前那句客氣的「最後通知」。你通常會以「棄用警告(deprecation warning)」的形式遇到它,出現在主控台或文件裡,而且往往會直接告訴你該改用什麼。

明智的做法是:趁它還只是個警告時就動手處理。已棄用的程式碼是在「借來的時間」裡苟活——現在就按自己的節奏遷移到替代方案,別等到將來某次升級真把它刪掉時手忙腳亂。

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

一條典型的棄用警告——注意,它連替代方案都直接告訴你了。

「已棄用」是「不建議用」,不是「已刪除」——這個詞源自拉丁語,本意是「祈求避開」。

又稱
deprecationdeprecation warningsunsetlegacy