API 的稳定性

    在此处，稳定意味着：

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

    有关 Django 是如何编写版本号以及一些功能是如何被弃用的详细信息，请看： ref:official-releases

    • 我们只有在某些 API 中的一个 bug 或者 安全问题导致问题完全不能避免的时候，我们才会移除对这些 API 的向后兼容。

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

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

    标记为内部的API

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