导航|地址|刷新
Getting started with Django

Skip to main content
Django
The web framework for perfectionists with deadlines.
MenuMain navigation
Overview

Download

Documentation

News

Code

Issues

Community

Foundation

♥ Donate

Search提交
切换主题（当前主题：自动）

切换主题（当前主题：浅色）

切换主题（当前主题：深色）

Toggle Light / Dark / Auto color theme

It’s quick & easy to get up and running with Django.

Download version 6.0.7

Getting started with Django

Depending how new you are to Django, you can try a tutorial, or just dive into the documentation.

Want to learn more about Django? Read the overview to see whether Django is right for your project.
Django overview

Install Django

Before you can use Django, you’ll need to install it. Our complete installation guide covers all the possibilities; this guide will get you to a simple, minimal installation that’ll work while you walk through the introduction.
Django installation guide

Write your first Django app

Installed Django already? Good. Now try this tutorial, which walks you through creating a basic poll application. It’s got two parts:

A public site that lets people view polls and vote in them.

An administrative interface that lets you add, change and delete polls.
Take the tutorial

Sharpen your skills

The official Django documentation covers everything you need to know about Django (and then some).
Read the docs

Join the community

You can help make us better. Find out about upcoming Django events, learn what’s on other Django developers’ minds, find and post jobs, and more.
Join us

Intro to Django

Object-relational mapper

Deﬁne your data models entirely in Python. You get a rich, dynamic database-access API for free — but you can still write SQL if needed.
Read more
fromdjango.dbimportmodelsclassBand(models.Model):"""A model of a rock band."""name=models.CharField(max_length=200)can_rock=models.BooleanField(default=True)classMember(models.Model):"""A model of a rock band member."""name=models.CharField("Member's name",max_length=200)instrument=models.CharField(choices=(("g","Guitar"),("b","Bass"),("d","Drums"),),max_length=1,)band=models.ForeignKey("Band")

URLs and views

A clean, elegant URL scheme is an important detail in a high-quality web application. Django encourages beautiful URL design and doesn’t put any cruft in URLs, like .php or .asp.

To design URLs for an application, you create a Python module called a URLconf. Like a table of contents for your app, it contains a simple mapping between URL patterns and your views.
Read more
fromdjango.urlsimportpathfrom.importviewsurlpatterns=[path("bands/",views.band_listing,name="band-list"),path("bands/<int:band_id>/",views.band_detail,name="band-detail"),path("bands/search/",views.band_search,name="band-search"),]

frombands.modelsimportBandfromdjango.shortcutsimportrenderdefband_listing(request):"""A view of all bands."""bands=Band.objects.all()returnrender(request,"bands/band_listing.html",{"bands":bands})

Templates

Django’s template language is designed to strike a balance between power and ease. It’s designed to feel comfortable and easy-to-learn to those used to working with HTML, like designers and front-end developers. But it is also flexible and highly extensible, allowing developers to augment the template language as needed.
Read more
<html> <head> <title>{%translate"Band Listing"%}</title> </head> <body> <h1>{%translate"All Bands"%}</h1> <ul>{%forbandinbands%} <li> <h2><a href="{{band.get_absolute_url}}">{{band.name}}</a></h2>{%ifband.can_rock%}<p>{%translate"This band can rock!"%}</p>{%endif%} </li>{%endfor%} </ul> </body></html>

Forms

Django provides a powerful form library that handles rendering forms as HTML, validating user-submitted data, and converting that data to native Python types. Django also provides a way to generate forms from your existing models and use those forms to create and update data.
Read more
fromdjangoimportformsclassBandContactForm(forms.Form):subject=forms.CharField(max_length=100)message=forms.TextField()sender=forms.EmailField()cc_myself=forms.BooleanField(required=False)

Authentication

Django comes with a full-featured and secure authentication system. It handles user accounts, groups, permissions and cookie-based user sessions. This lets you easily build sites that allow users to create accounts and safely log in/out.
Read more
fromdjango.contrib.auth.decoratorsimportlogin_requiredfromdjango.shortcutsimportrender@login_requireddefmy_protected_view(request):"""A view that can only be accessed by logged-in users"""returnrender(request,"protected.html",{"current_user":request.user})

Admin

One of the most powerful parts of Django is its automatic admin interface. It reads metadata in your models to provide a powerful and production-ready interface that content producers can immediately use to start managing content on your site. It’s easy to set up and provides many hooks for customization.
Read more
frombands.modelsimportBand,Memberfromdjango.contribimportadminclassMemberAdmin(admin.ModelAdmin):"""Customize the look of the auto-generated admin for the Member model"""list_display=("name","instrument")list_filter=("band",)admin.site.register(Band)# Use the default optionsadmin.site.register(Member,MemberAdmin)# Use the customized options

Internationalization

Django offers full support for translating text into different languages, plus locale-specific formatting of dates, times, numbers, and time zones. It lets developers and template authors specify which parts of their apps should be translated or formatted for local languages and cultures, and it uses these hooks to localize web applications for particular users according to their preferences.
Read more
fromdjango.shortcutsimportrenderfromdjango.utils.translationimportgettextdefhomepage(request):""" Shows the homepage with a welcome message that is translated in the user's language. """message=gettext("Welcome to our site!")returnrender(request,"homepage.html",{"message":message})

{%loadi18n%}<html> <head> <title>{%translate"Homepage - Hall of Fame"%}</title> </head> <body>{# Translated in the view: #} <h1>{{message}}</h1> <p>{%blocktranslatecountmember_count=bands.count%} Here is the only band in the hall of fame:{%plural%} Here are all the {{member_count}} bands in the hall of fame:{%endblocktranslate%} </p> <ul>{%forbandinbands%} <li> <h2><a href="{{band.get_absolute_url}}">{{band.name}}</a></h2>{%ifband.can_rock%}<p>{%translate'This band can rock!'%}</p>{%endif%} </li>{%endfor%} </ul> </body></html>

Security

Django provides multiple protections against:

Clickjacking

Cross-site scripting

Cross Site Request Forgery (CSRF)

SQL injection

Remote code execution
Read more

Back to Top

Django Links

Learn More

About Django

Getting Started with Django

Team Organization

Django Software Foundation

Code of Conduct

Diversity Statement

Get Involved

Join a Group

Contribute to Django

Submit a Bug

Report a Security Issue

Individual membership

Get Help

Getting Help FAQ

Django Discord

Official Django Forum

Follow Us

GitHub

X

Fediverse (Mastodon)

Bluesky

LinkedIn

News RSS

Support Us

Sponsor Django

Corporate membership

Official merchandise store

Benevity Workplace Giving Program

Django

Hosting byIn-kind donors

Design byThreespot&andrevv

© 2005-2026 Django Software Foundation and individual contributors. Django is a registered trademark of the Django Software Foundation.

------
导航页打开网址