如何在生产代码中处理函数名称错误？

我最近在GitHub上遇到了一个Python库。该库很棒，但是在函数名称中包含一个明显的错字。让我们称它为dummy_fuction()应该dummy_function()。此功能肯定是“狂野的”，最有可能在嵌入式系统中使用。

我想到的第一件事是添加具有正确名称的函数的第二个版本，并为下一版本的第一个版本添加弃用警告。

三个问题：

1. 上面的方法会产生意想不到的后果吗？
2. 是否有解决此类问题的标准方法？
3. 弃用警告应保留多长时间？

首先，该政策取决于维护者。

我认为您的问题很有趣，但主要基于观点。

以我个人的观点，您的方法是正确的-重命名该函数，并将拼写错误的版本保留为已弃用的工件，然后重定向到正确的工件。

上面的方法会产生意想不到的后果吗？

它可能会破坏代码，例如。如果有人不能忍受拼写错误，并实施了自己的重命名版本。现在，一旦他们更新库，就会发生名称冲突。

是否有解决此类问题的标准方法？

编写库时不要犯拼写错误；）

弃用警告应保留多长时间？

我认为应该在下一个主要发行版之前（版本号的第一位增加时）保留弃用项。

在这种情况下，某些（有道理的）向后兼容性破坏是可以容忍的，并且库用户有责任确保他们的代码仍然可以正常构建。

只需确保在变更日志中指出：伙计们，如果您使用过dummy_fuction，请将其替换为dummy_function任何地方，那么您就很好了。

如果未对库进行版本控制，那么最好开始对其进行版本控制。