API 的稳定性

    在将 API 的稳定性作为一个非常重要的优先级的同时，Django 还致力于持续的改进，并致力于在我们提供的 API 中实现“一种方法”（最终）。这意味着，当我们发现明显更好的实现方式时，我们会弃用旧的方式，并最终将其移除。我们的目标是提供一个现代的、可靠的、高质量的 web 框架，帮助所有使用它的项目的使用最佳实践。通过使用渐进式的改进，我们试图避免停滞和大规模破坏性升级。

    在此处，稳定意味着：

    • 所有发布的 API （在文档中的一切 API ）在不提供向后兼容的别名的情况下，都不会被移除或者重命名。

    • 如果一个 bug 或安全漏洞完全不可避免，我们才会直接打破这些 API 的向后兼容性而不走弃用过程。

    这种稳定性和向后兼容性承诺有一些例外。

    如果我们发现了安全问题 —希望报告者遵照我们的 --我们会尽一切努力解决它。 这可能意味着打破向后兼容性; 安全性优先于兼容性保证。

    标记为内部的 API

    某些API在几种方式中被明确标记为 “内部” :

    • 一些文档提及了这些 API 并标为“内部”，如果确实如此，我们保留修改它的权利。
    • 一些函数，方法以及其他对象以下划线“_”开头，这是 Python 声明其为“私有”的标准方式，如果一个方法以单下划线“_”开头，那么这意味着它是 Django 内部的一个 API。