---
title: "Django 5.2 release notes"
version: 6.0
locale: zh-hans
source: https://docs.djangoproject.com/zh-hans/6.0/releases/5.2/
canonical: https://djangodocs.dev/zh-hans/6.0/releases/5.2/
---
# Django 5.2 release notes
*April 2, 2025*
Welcome to Django 5.2!
These release notes cover the [new features](#whats-new-5-2), as well as
some [backwards incompatible changes](#backwards-incompatible-5-2) you
should be aware of when upgrading from Django 5.1 or earlier. We've
[begun the deprecation process for some features](#deprecated-features-5-2).
如果你要更新现有的项目，请看 [如何将 Django 更新至新的版本](/zh-hans/6.0/howto/upgrade-version/) 指南。
Django 5.2 is designated as a [long-term support release](/zh-hans/6.0/internals/release-process/#term-Long-term-support-release). It will receive security updates for at least
three years after its release. Support for the previous LTS, Django 4.2, will
end in April 2026.
## Python 兼容性
Django 5.2 supports Python 3.10, 3.11, 3.12, 3.13, and 3.14 (as of 5.2.8). We
**highly recommend** and only officially support the latest release of each
series.
## What's new in Django 5.2
### Automatic models import in the `shell`
The [`shell`](/zh-hans/6.0/ref/django-admin/#django-admin-shell) management command now automatically imports models from
all installed apps. You can view further details of the imported objects by
setting the `--verbosity` flag to 2 or more:
```console
$ python -Wall manage.py shell --verbosity=2
6 objects imported automatically, including:
from django.contrib.admin.models import LogEntry
from django.contrib.auth.models import Group, Permission, User
from django.contrib.contenttypes.models import ContentType
from django.contrib.sessions.models import Session
```
*Windows*
```doscon
...\> py -Wall manage.py shell --verbosity=2
6 objects imported automatically, including:
from django.contrib.admin.models import LogEntry
from django.contrib.auth.models import Group, Permission, User
from django.contrib.contenttypes.models import ContentType
from django.contrib.sessions.models import Session
```
This [behavior can be customized](/zh-hans/6.0/howto/custom-shell/#customizing-shell-auto-imports) to add
or remove automatic imports.
### Composite Primary Keys
The new [`django.db.models.CompositePrimaryKey`](/zh-hans/6.0/ref/models/fields/#django.db.models.CompositePrimaryKey) allows tables to be
created with a primary key consisting of multiple fields.
To use a composite primary key, when defining a model set the `pk` attribute
to be a `CompositePrimaryKey`:
```
from django.db import models
class Release(models.Model):
pk = models.CompositePrimaryKey("version", "name")
version = models.IntegerField()
name = models.CharField(max_length=20)
```
See [Composite primary keys](/zh-hans/6.0/topics/composite-primary-key/) for more details.
### Simplified override of [`BoundField`](/zh-hans/6.0/ref/forms/api/#django.forms.BoundField)
Prior to version 5.2, overriding [`Field.get_bound_field()`](/zh-hans/6.0/ref/forms/fields/#django.forms.Field.get_bound_field) was the only
option to use a custom [`BoundField`](/zh-hans/6.0/ref/forms/api/#django.forms.BoundField). Django now supports
specifying the following attributes to customize form rendering:
- [`BaseRenderer.bound_field_class`](/zh-hans/6.0/ref/forms/renderers/#django.forms.renderers.BaseRenderer.bound_field_class) at the project level,
- [`Form.bound_field_class`](/zh-hans/6.0/ref/forms/api/#django.forms.Form.bound_field_class) at the form level, and
- [`Field.bound_field_class`](/zh-hans/6.0/ref/forms/fields/#django.forms.Field.bound_field_class) at the field level.
For example, to customize the `BoundField` of a `Form` class:
```
from django import forms
class CustomBoundField(forms.BoundField):
custom_class = "custom"
def css_classes(self, extra_classes=None):
result = super().css_classes(extra_classes)
if self.custom_class not in result:
result += f" {self.custom_class}"
return result.strip()
class CustomForm(forms.Form):
bound_field_class = CustomBoundField
name = forms.CharField(
label="Your Name",
max_length=100,
required=False,
widget=forms.TextInput(attrs={"class": "name-input-class"}),
)
email = forms.EmailField(label="Your Email")
```
When rendering a `CustomForm` instance, the following HTML is included:
```html
```
See [自定义 BoundField](/zh-hans/6.0/ref/forms/api/#custom-boundfield) for more details about this feature.
### 次要特性
#### [`django.contrib.admin`](/zh-hans/6.0/ref/contrib/admin/#module-django.contrib.admin)
- The `admin/base.html` template now has a new block
[extrabody](/zh-hans/6.0/ref/contrib/admin/#extrabody) for adding custom code before the closing
`
` tag.
- The value of a [`URLField`](/zh-hans/6.0/ref/models/fields/#django.db.models.URLField) now renders as a link.
#### [`django.contrib.admindocs`](/zh-hans/6.0/ref/contrib/admin/admindocs/#module-django.contrib.admindocs)
- Links to components in docstrings now supports custom link text, using the
format `` :role:`link text