25、Ruby 编程：处理变更与设计模式运用

Ruby 编程：处理变更与设计模式运用

1. 合理移除特性

对于许多新手程序员而言，移除特性似乎并非好事，但对经验丰富的程序员来说，这或许是最令人愉悦的时刻之一。要明白，虽然大多数用户将特性视为资产，但在维护库时，特性更应被看作负债，因为每个特性都有维护成本。为所维护的库添加新特性，只会增加未来的维护负担；而移除特性，则是摆脱负债，这也是经验丰富的程序员乐于移除特性的原因之一。

显然，没有特性的库毫无价值，所以库中包含的特性应是有用的，而非无用甚至有害。然而，在添加特性时，往往难以预见其未来是否仍有用。有时，最初看似很棒的新特性，5 年后可能会成为大问题。经验丰富的程序员乐于移除特性，通常是因为这些特性阻碍了库的发展，或带来了巨大的维护负担。仅仅想到不必再处理有问题的特性，就足以让移除者感到愉悦。

作为负责任的库维护者，不能随意移除库中的特性，因为这可能会破坏依赖该库的代码。为减轻用户的负担，需要正确地弃用特性，具体方法取决于特性本身。

1.1 移除方法

如果特性是一个方法，最简单的弃用方式是在方法内部调用 warn 方法。确保包含被调用方法的名称（可通过 __callee__ 获取），并使用 :uplevel 关键字参数，这样错误信息中会包含调用者的文件名和行号。在 Ruby 3 中，还可使用 :category 关键字参数并设置为 :deprecated ，将警告标记为弃用警告，方便库的用户查看需要修复的方法。示例代码如下：