简体中文 繁體中文 English Deutsch 한국 사람 بالعربية TÜRKÇE português คนไทย Français Japanese

开启辅助访问 切换到宽版

站内搜索

搜索

活动公告

通知：为庆祝网站一周年，将在5.1日与5.2日开放注册，具体信息请见后续详细公告
04-22 00:04
通知：本站资源由网友上传分享，如有违规等问题请到版务模块进行投诉，资源失效请在帖子内回复要求补档，会尽快处理！
10-23 09:31
>社区 > 科技 > 经验交流 >帖子
本版发帖返回

从零开始掌握Django新建项目完整指南 让初学者也能轻松搭建高效稳定的Web应用框架

威震华夏关云长
SunJu_FaceMall

3万

主题

1158

科技点

3万

积分

白金月票

碾压王

积分
32796

立华奏
发表于 2025-8-22 15:00:45 | 显示全部楼层 |阅读模式

马上注册，结交更多好友，享用更多功能，让你轻松玩转社区。

您需要 登录 才可以下载或查看，没有账号？立即注册

x
引言

Django是一个由Python编写的高级Web框架，它遵循MVT（Model-View-Template）架构模式，旨在帮助开发者快速构建安全、可扩展的Web应用程序。作为初学者，掌握Django不仅能让你快速进入Web开发领域，还能为你提供一个强大的工具来构建从简单博客到复杂企业级应用的各种网站。

本指南将带您从零开始，逐步学习如何创建、配置和部署一个完整的Django项目。无论您是否有Web开发经验，通过本指南的详细步骤和实例，您将能够轻松搭建高效稳定的Web应用框架。

1. 环境准备

1.1 安装Python

Django是基于Python的框架，因此首先需要确保您的系统上安装了Python。Django 3.2及以上版本需要Python 3.6或更高版本。

在Windows上：

1. 访问Python官方网站(https://www.python.org/downloads/)
2. 下载最新版本的Python安装程序
3. 运行安装程序，确保勾选”Add Python to PATH”选项

在macOS上：
  2. # 使用Homebrew安装
  3. brew install python
  5. # 或者从官网下载安装程序
复制代码

在Linux上（以Ubuntu为例）：
  2. sudo apt update
  3. sudo apt install python3 python3-pip
复制代码

验证Python安装：
  2. python --version
  3. # 或者
  4. python3 --version
复制代码

1.2 设置虚拟环境

虚拟环境可以为每个项目创建独立的Python环境，避免不同项目之间的依赖冲突。

安装虚拟环境工具：
  2. pip install virtualenv
复制代码

创建项目目录并设置虚拟环境：
  2. # 创建项目目录
  3. mkdir myproject
  4. cd myproject
  6. # 创建虚拟环境
  7. virtualenv venv
  9. # 激活虚拟环境
  10. # Windows:
  11. venv\Scripts\activate
  12. # macOS/Linux:
  13. source venv/bin/activate
复制代码

激活后，命令行前面会显示(venv)，表示您现在处于虚拟环境中。

1.3 安装Django

在虚拟环境中安装Django：
  2. pip install django
复制代码

验证Django安装：
  2. django-admin --version
复制代码

2. 创建第一个Django项目

2.1 使用django-admin创建项目

Django提供了一个命令行工具django-admin来帮助创建项目骨架。
  2. django-admin startproject myproject
复制代码

这将在当前目录下创建一个名为myproject的目录，包含项目的基本结构。

2.2 项目结构解析

创建的项目结构如下：
  2. myproject/
  3.     manage.py
  4.     myproject/
  5.         __init__.py
  6.         settings.py
  7.         urls.py
  8.         asgi.py
  9.         wsgi.py
复制代码

各文件和目录的作用：

• manage.py：Django项目的命令行工具，用于执行各种管理任务。
• myproject/：项目的主包，包含项目的配置。__init__.py：空文件，告诉Python这是一个包。settings.py：项目的配置文件，包含所有设置。urls.py：URL声明，定义URL模式到视图的映射。asgi.py：ASGI兼容的Web服务器入口，用于部署。wsgi.py：WSGI兼容的Web服务器入口，用于部署。
• __init__.py：空文件，告诉Python这是一个包。
• settings.py：项目的配置文件，包含所有设置。
• urls.py：URL声明，定义URL模式到视图的映射。
• asgi.py：ASGI兼容的Web服务器入口，用于部署。
• wsgi.py：WSGI兼容的Web服务器入口，用于部署。

• __init__.py：空文件，告诉Python这是一个包。
• settings.py：项目的配置文件，包含所有设置。
• urls.py：URL声明，定义URL模式到视图的映射。
• asgi.py：ASGI兼容的Web服务器入口，用于部署。
• wsgi.py：WSGI兼容的Web服务器入口，用于部署。

2.3 开发服务器

Django自带一个轻量级的开发服务器，便于开发和测试。
  2. cd myproject
  3. python manage.py runserver
复制代码

默认情况下，服务器将在本地8000端口运行。访问http://127.0.0.1:8000/，如果看到Django的欢迎页面，说明项目已成功创建。

3. 创建Django应用

在Django中，一个项目可以包含多个应用。应用是Web应用程序的一个功能模块，例如博客、用户系统、支付系统等。

3.1 创建应用

使用startapp命令创建应用：
  2. python manage.py startapp blog
复制代码

这将在项目目录下创建一个名为blog的应用，结构如下：
  2. blog/
  3.     __init__.py
  4.     admin.py
  5.     apps.py
  6.     migrations/
  7.         __init__.py
  8.     models.py
  9.     tests.py
  10.     views.py
复制代码

3.2 注册应用

创建应用后，需要在项目的settings.py文件中注册它，以便Django能够识别并包含它：
  2. # myproject/settings.py
  4. INSTALLED_APPS = [
  5.     'django.contrib.admin',
  6.     'django.contrib.auth',
  7.     'django.contrib.contenttypes',
  8.     'django.contrib.sessions',
  9.     'django.contrib.messages',
  10.     'django.contrib.staticfiles',
  11.     'blog',  # 添加新创建的应用
  12. ]
复制代码

4. 配置数据库

4.1 数据库设置

Django默认使用SQLite数据库，这对于开发和小型项目来说是一个很好的选择。在settings.py中，数据库配置如下：
  2. # myproject/settings.py
  4. DATABASES = {
  5.     'default': {
  6.         'ENGINE': 'django.db.backends.sqlite3',
  7.         'NAME': BASE_DIR / 'db.sqlite3',
  8.     }
  9. }
复制代码

如果您想使用其他数据库，如MySQL或PostgreSQL，可以修改配置：
  2. # MySQL配置示例
  3. DATABASES = {
  4.     'default': {
  5.         'ENGINE': 'django.db.backends.mysql',
  6.         'NAME': 'mydatabase',
  7.         'USER': 'mydatabaseuser',
  8.         'PASSWORD': 'mypassword',
  9.         'HOST': 'localhost',
  10.         'PORT': '3306',
  11.     }
  12. }
复制代码

4.2 数据库迁移

在定义模型后，需要创建并应用数据库迁移：
  2. # 创建迁移文件
  3. python manage.py makemigrations
  5. # 应用迁移
  6. python manage.py migrate
复制代码

5. 创建模型

模型是数据的单一、明确的信息来源，它包含您存储的数据的基本字段和行为。

5.1 定义模型

在blog/models.py中定义模型：
  2. from django.db import models
  3. from django.contrib.auth.models import User
  5. class Category(models.Model):
  6.     name = models.CharField(max_length=100)
  7.     description = models.TextField(blank=True)
  8.    
  9.     def __str__(self):
  10.         return self.name
  12. class Tag(models.Model):
  13.     name = models.CharField(max_length=100)
  14.    
  15.     def __str__(self):
  16.         return self.name
  18. class Post(models.Model):
  19.     STATUS_CHOICES = (
  20.         ('draft', 'Draft'),
  21.         ('published', 'Published'),
  22.     )
  23.    
  24.     title = models.CharField(max_length=200)
  25.     slug = models.SlugField(max_length=250, unique_for_date='publish')
  26.     author = models.ForeignKey(User, on_delete=models.CASCADE, related_name='blog_posts')
  27.     content = models.TextField()
  28.     created_at = models.DateTimeField(auto_now_add=True)
  29.     updated_at = models.DateTimeField(auto_now=True)
  30.     publish = models.DateTimeField(default=timezone.now)
  31.     status = models.CharField(max_length=10, choices=STATUS_CHOICES, default='draft')
  32.     categories = models.ManyToManyField(Category, related_name='posts')
  33.     tags = models.ManyToManyField(Tag, related_name='posts', blank=True)
  34.    
  35.     class Meta:
  36.         ordering = ['-publish']
  37.    
  38.     def __str__(self):
  39.         return self.title
  41. class Comment(models.Model):
  42.     post = models.ForeignKey(Post, on_delete=models.CASCADE, related_name='comments')
  43.     name = models.CharField(max_length=100)
  44.     email = models.EmailField()
  45.     content = models.TextField()
  46.     created_at = models.DateTimeField(auto_now_add=True)
  47.     updated_at = models.DateTimeField(auto_now=True)
  48.     active = models.BooleanField(default=True)
  49.    
  50.     class Meta:
  51.         ordering = ['-created_at']
  52.    
  53.     def __str__(self):
  54.         return f'Comment by {self.name} on {self.post}'
复制代码

5.2 激活模型

定义模型后，需要创建并应用迁移：
  2. python manage.py makemigrations blog
  3. python manage.py migrate
复制代码

5.3 注册模型到管理界面

要在Django管理界面中管理模型，需要在blog/admin.py中注册它们：
  2. from django.contrib import admin
  3. from .models import Category, Tag, Post, Comment
  5. @admin.register(Category)
  6. class CategoryAdmin(admin.ModelAdmin):
  7.     list_display = ['name', 'description']
  8.     search_fields = ['name']
  10. @admin.register(Tag)
  11. class TagAdmin(admin.ModelAdmin):
  12.     list_display = ['name']
  13.     search_fields = ['name']
  15. @admin.register(Post)
  16. class PostAdmin(admin.ModelAdmin):
  17.     list_display = ['title', 'author', 'publish', 'status']
  18.     list_filter = ['status', 'created_at', 'publish', 'author']
  19.     search_fields = ['title', 'content']
  20.     prepopulated_fields = {'slug': ('title',)}
  21.     raw_id_fields = ['author']
  22.     date_hierarchy = 'publish'
  23.     ordering = ['status', '-publish']
  25. @admin.register(Comment)
  26. class CommentAdmin(admin.ModelAdmin):
  27.     list_display = ['name', 'email', 'post', 'created_at', 'active']
  28.     list_filter = ['active', 'created_at']
  29.     search_fields = ['name', 'email', 'content']
复制代码

6. 视图和URL配置

视图处理Web请求并返回响应。URL配置将URL映射到视图。

6.1 创建视图

在blog/views.py中创建视图：
  2. from django.shortcuts import render, get_object_or_404
  3. from django.core.paginator import Paginator, EmptyPage, PageNotAnInteger
  4. from .models import Post, Category, Tag
  6. def post_list(request, category_slug=None, tag_slug=None):
  7.     posts = Post.objects.filter(status='published')
  8.    
  9.     # 按分类过滤
  10.     if category_slug:
  11.         category = get_object_or_404(Category, slug=category_slug)
  12.         posts = posts.filter(categories=category)
  13.    
  14.     # 按标签过滤
  15.     if tag_slug:
  16.         tag = get_object_or_404(Tag, slug=tag_slug)
  17.         posts = posts.filter(tags=tag)
  18.    
  19.     # 分页
  20.     paginator = Paginator(posts, 5)  # 每页5篇文章
  21.     page = request.GET.get('page')
  22.    
  23.     try:
  24.         posts = paginator.page(page)
  25.     except PageNotAnInteger:
  26.         # 如果page参数不是整数，返回第一页
  27.         posts = paginator.page(1)
  28.     except EmptyPage:
  29.         # 如果page超出范围，返回最后一页
  30.         posts = paginator.page(paginator.num_pages)
  31.    
  32.     context = {
  33.         'posts': posts,
  34.         'page': page,
  35.     }
  36.    
  37.     return render(request, 'blog/post/list.html', context)
  39. def post_detail(request, year, month, day, post):
  40.     post = get_object_or_404(
  41.         Post,
  42.         slug=post,
  43.         status='published',
  44.         publish__year=year,
  45.         publish__month=month,
  46.         publish__day=day
  47.     )
  48.    
  49.     # 获取文章的评论
  50.     comments = post.comments.filter(active=True)
  51.    
  52.     context = {
  53.         'post': post,
  54.         'comments': comments,
  55.     }
  56.    
  57.     return render(request, 'blog/post/detail.html', context)
复制代码

6.2 创建URL配置

首先，在blog应用目录下创建urls.py文件：
  2. from django.urls import path
  3. from . import views
  5. app_name = 'blog'
  7. urlpatterns = [
  8.     # 文章列表
  9.     path('', views.post_list, name='post_list'),
  10.     path('category/<slug:category_slug>/', views.post_list, name='post_list_by_category'),
  11.     path('tag/<slug:tag_slug>/', views.post_list, name='post_list_by_tag'),
  12.    
  13.     # 文章详情
  14.     path('<int:year>/<int:month>/<int:day>/<slug:post>/',
  15.          views.post_detail,
  16.          name='post_detail'),
  17. ]
复制代码

然后，在项目的主urls.py文件中包含应用的URL配置：
  2. from django.contrib import admin
  3. from django.urls import path, include
  5. urlpatterns = [
  6.     path('admin/', admin.site.urls),
  7.     path('', include('blog.urls')),
  8. ]
复制代码

7. 模板系统

Django的模板系统允许您将业务逻辑与表示层分离。

7.1 创建模板目录结构

在blog应用目录下创建以下目录结构：
  2. blog/
  3.     templates/
  4.         blog/
  5.             base.html
  6.             post/
  7.                 list.html
  8.                 detail.html
复制代码

7.2 创建基础模板

blog/templates/blog/base.html:
  2. {% load static %}
  3. <!DOCTYPE html>
  4. <html lang="en">
  5. <head>
  6.     <meta charset="UTF-8">
  7.     <meta name="viewport" content="width=device-width, initial-scale=1.0">
  8.     <title>{% block title %}My Blog{% endblock %}</title>
  9.     <link rel="stylesheet" href="{% static 'css/blog.css' %}">
  10. </head>
  11. <body>
  12.     <header>
  13.         <h1><a href="{% url 'blog:post_list' %}">My Blog</a></h1>
  14.         <nav>
  15.             <ul>
  16.                 <li><a href="{% url 'blog:post_list' %}">Home</a></li>
  17.                 <!-- 可以添加更多导航链接 -->
  18.             </ul>
  19.         </nav>
  20.     </header>
  21.    
  22.     <main>
  23.         {% block content %}
  24.         {% endblock %}
  25.     </main>
  26.    
  27.     <footer>
  28.         <p>&copy; {% now "Y" %} My Blog. All rights reserved.</p>
  29.     </footer>
  30.    
  31.     <script src="{% static 'js/blog.js' %}"></script>
  32. </body>
  33. </html>
复制代码

7.3 创建文章列表模板

blog/templates/blog/post/list.html:
  2. {% extends "blog/base.html" %}
  4. {% block title %}My Blog - Latest Posts{% endblock %}
  6. {% block content %}
  7.     <h1>Latest Posts</h1>
  8.    
  9.     {% for post in posts %}
  10.         <article class="post">
  11.             <h2><a href="{{ post.get_absolute_url }}">{{ post.title }}</a></h2>
  12.             <p class="post-meta">
  13.                 Published on {{ post.publish }} by {{ post.author }}
  14.             </p>
  15.             <p class="post-content">
  16.                 {{ post.content|truncatewords:30 }}
  17.             </p>
  18.             <div class="post-categories">
  19.                 Categories:
  20.                 {% for category in post.categories.all %}
  21.                     <a href="{% url 'blog:post_list_by_category' category.slug %}">{{ category.name }}</a>
  22.                     {% if not forloop.last %}, {% endif %}
  23.                 {% endfor %}
  24.             </div>
  25.             <div class="post-tags">
  26.                 Tags:
  27.                 {% for tag in post.tags.all %}
  28.                     <a href="{% url 'blog:post_list_by_tag' tag.slug %}">{{ tag.name }}</a>
  29.                     {% if not forloop.last %}, {% endif %}
  30.                 {% endfor %}
  31.             </div>
  32.         </article>
  33.     {% empty %}
  34.         <p>No posts available.</p>
  35.     {% endfor %}
  36.    
  37.     <!-- 分页 -->
  38.     {% if posts.has_other_pages %}
  39.         <div class="pagination">
  40.             {% if posts.has_previous %}
  41.                 <a href="?page={{ posts.previous_page_number }}">&laquo; Previous</a>
  42.             {% endif %}
  43.             
  44.             <span class="page-current">
  45.                 Page {{ posts.number }} of {{ posts.paginator.num_pages }}
  46.             </span>
  47.             
  48.             {% if posts.has_next %}
  49.                 <a href="?page={{ posts.next_page_number }}">Next &raquo;</a>
  50.             {% endif %}
  51.         </div>
  52.     {% endif %}
  53. {% endblock %}
复制代码

7.4 创建文章详情模板

blog/templates/blog/post/detail.html:
  2. {% extends "blog/base.html" %}
  4. {% block title %}{{ post.title }}{% endblock %}
  6. {% block content %}
  7.     <article class="post-detail">
  8.         <h1>{{ post.title }}</h1>
  9.         <p class="post-meta">
  10.             Published on {{ post.publish }} by {{ post.author }}
  11.         </p>
  12.         
  13.         <div class="post-content">
  14.             {{ post.content|linebreaks }}
  15.         </div>
  16.         
  17.         <div class="post-categories">
  18.             Categories:
  19.             {% for category in post.categories.all %}
  20.                 <a href="{% url 'blog:post_list_by_category' category.slug %}">{{ category.name }}</a>
  21.                 {% if not forloop.last %}, {% endif %}
  22.             {% endfor %}
  23.         </div>
  24.         
  25.         <div class="post-tags">
  26.             Tags:
  27.             {% for tag in post.tags.all %}
  28.                 <a href="{% url 'blog:post_list_by_tag' tag.slug %}">{{ tag.name }}</a>
  29.                 {% if not forloop.last %}, {% endif %}
  30.             {% endfor %}
  31.         </div>
  32.     </article>
  33.    
  34.     <section class="comments">
  35.         <h2>Comments</h2>
  36.         
  37.         {% for comment in comments %}
  38.             <div class="comment">
  39.                 <h3>{{ comment.name }}</h3>
  40.                 <p class="comment-meta">
  41.                     On {{ comment.created_at }}
  42.                 </p>
  43.                 <p>{{ comment.content|linebreaks }}</p>
  44.             </div>
  45.         {% empty %}
  46.             <p>There are no comments yet.</p>
  47.         {% endfor %}
  48.     </section>
  49. {% endblock %}
复制代码

8. 静态文件管理

静态文件包括CSS、JavaScript、图像等。

8.1 配置静态文件

在settings.py中配置静态文件：
  2. # myproject/settings.py
  4. STATIC_URL = '/static/'
  5. STATIC_ROOT = BASE_DIR / 'staticfiles'
  7. STATICFILES_DIRS = [
  8.     BASE_DIR / 'static',
  9. ]
复制代码

8.2 创建静态文件目录结构

在项目根目录下创建静态文件目录结构：
  2. static/
  3.     css/
  4.         blog.css
  5.     js/
  6.         blog.js
  7.     images/
复制代码

8.3 示例静态文件

static/css/blog.css:
  2. /* 基本样式 */
  3. body {
  4.     font-family: Arial, sans-serif;
  5.     line-height: 1.6;
  6.     margin: 0;
  7.     padding: 0;
  8.     color: #333;
  9. }
  11. /* 布局 */
  12. header {
  13.     background-color: #333;
  14.     color: #fff;
  15.     padding: 1rem;
  16.     text-align: center;
  17. }
  19. header h1 a {
  20.     color: #fff;
  21.     text-decoration: none;
  22. }
  24. nav ul {
  25.     padding: 0;
  26.     list-style: none;
  27. }
  29. nav ul li {
  30.     display: inline;
  31.     margin: 0 10px;
  32. }
  34. nav ul li a {
  35.     color: #fff;
  36.     text-decoration: none;
  37. }
  39. main {
  40.     max-width: 800px;
  41.     margin: 2rem auto;
  42.     padding: 0 1rem;
  43. }
  45. footer {
  46.     background-color: #333;
  47.     color: #fff;
  48.     text-align: center;
  49.     padding: 1rem;
  50.     margin-top: 2rem;
  51. }
  53. /* 文章样式 */
  54. .post {
  55.     margin-bottom: 2rem;
  56.     padding-bottom: 1rem;
  57.     border-bottom: 1px solid #ddd;
  58. }
  60. .post h2 a {
  61.     color: #333;
  62.     text-decoration: none;
  63. }
  65. .post h2 a:hover {
  66.     color: #0066cc;
  67. }
  69. .post-meta {
  70.     color: #666;
  71.     font-size: 0.9rem;
  72.     margin-bottom: 1rem;
  73. }
  75. .post-content {
  76.     margin-bottom: 1rem;
  77. }
  79. .post-categories, .post-tags {
  80.     margin-top: 0.5rem;
  81.     font-size: 0.9rem;
  82. }
  84. .post-categories a, .post-tags a {
  85.     color: #0066cc;
  86.     text-decoration: none;
  87. }
  89. .post-categories a:hover, .post-tags a:hover {
  90.     text-decoration: underline;
  91. }
  93. /* 分页样式 */
  94. .pagination {
  95.     margin: 2rem 0;
  96.     text-align: center;
  97. }
  99. .pagination a {
  100.     color: #0066cc;
  101.     text-decoration: none;
  102.     padding: 0.5rem 1rem;
  103.     border: 1px solid #ddd;
  104.     margin: 0 0.25rem;
  105. }
  107. .pagination a:hover {
  108.     background-color: #f5f5f5;
  109. }
  111. .page-current {
  112.     padding: 0.5rem 1rem;
  113.     margin: 0 0.25rem;
  114. }
  116. /* 评论样式 */
  117. .comments {
  118.     margin-top: 3rem;
  119. }
  121. .comment {
  122.     margin-bottom: 1.5rem;
  123.     padding-bottom: 1rem;
  124.     border-bottom: 1px solid #eee;
  125. }
  127. .comment h3 {
  128.     margin-bottom: 0.25rem;
  129. }
  131. .comment-meta {
  132.     color: #666;
  133.     font-size: 0.9rem;
  134.     margin-bottom: 0.5rem;
  135. }
复制代码

static/js/blog.js:
  2. // 简单的JavaScript功能
  3. document.addEventListener('DOMContentLoaded', function() {
  4.     // 可以在这里添加交互功能
  5.     console.log('Blog loaded successfully!');
  6. });
复制代码

9. 用户认证系统

Django提供了强大的用户认证系统，包括用户注册、登录、注销和权限管理。

9.1 包含认证URL

在项目的主urls.py中添加Django认证系统的URL：
  2. from django.contrib import admin
  3. from django.urls import path, include
  5. urlpatterns = [
  6.     path('admin/', admin.site.urls),
  7.     path('', include('blog.urls')),
  8.     path('accounts/', include('django.contrib.auth.urls')),  # 添加认证URL
  9. ]
复制代码

9.2 创建认证模板

在blog/templates/registration/目录下创建以下模板：

login.html:
  2. {% extends "blog/base.html" %}
  4. {% block title %}Log In{% endblock %}
  6. {% block content %}
  7.     <h1>Log In</h1>
  8.    
  9.     <form method="post">
  10.         {% csrf_token %}
  11.         {{ form.as_p }}
  12.         <button type="submit">Log In</button>
  13.     </form>
  14.    
  15.     <p><a href="{% url 'password_reset' %}">Forgot your password?</a></p>
  16. {% endblock %}
复制代码

logged_out.html:
  2. {% extends "blog/base.html" %}
  4. {% block title %}Logged Out{% endblock %}
  6. {% block content %}
  7.     <h1>You have been logged out</h1>
  8.     <p><a href="{% url 'login' %}">Log in again</a></p>
  9. {% endblock %}
复制代码

password_reset_form.html:
  2. {% extends "blog/base.html" %}
  4. {% block title %}Reset Password{% endblock %}
  6. {% block content %}
  7.     <h1>Reset Password</h1>
  8.    
  9.     <form method="post">
  10.         {% csrf_token %}
  11.         {{ form.as_p }}
  12.         <button type="submit">Reset Password</button>
  13.     </form>
  14. {% endblock %}
复制代码

9.3 更新基础模板

在base.html中添加登录/注销链接：
  2. <header>
  3.     <h1><a href="{% url 'blog:post_list' %}">My Blog</a></h1>
  4.     <nav>
  5.         <ul>
  6.             <li><a href="{% url 'blog:post_list' %}">Home</a></li>
  7.             {% if user.is_authenticated %}
  8.                 <li><a href="{% url 'admin:index' %}">Admin</a></li>
  9.                 <li><a href="{% url 'logout' %}">Logout</a></li>
  10.             {% else %}
  11.                 <li><a href="{% url 'login' %}">Login</a></li>
  12.             {% endif %}
  13.         </ul>
  14.     </nav>
  15. </header>
复制代码

9.4 配置重定向URL

在settings.py中添加登录和注销后的重定向URL：
  2. # myproject/settings.py
  4. LOGIN_REDIRECT_URL = '/'
  5. LOGOUT_REDIRECT_URL = '/'
复制代码

10. 创建超级用户

要访问Django管理界面，需要创建一个超级用户：
  2. python manage.py createsuperuser
复制代码

按照提示输入用户名、电子邮件和密码。

11. 测试项目

11.1 创建测试数据

在Django shell中创建一些测试数据：
  2. python manage.py shell
复制代码
  2. from django.contrib.auth.models import User
  3. from blog.models import Category, Tag, Post
  4. from django.utils import timezone
  5. import datetime
  7. # 创建用户
  8. user = User.objects.create_user('testuser', 'test@example.com', 'password')
  10. # 创建分类
  11. category1 = Category.objects.create(name='Django', description='All about Django')
  12. category2 = Category.objects.create(name='Python', description='Python programming')
  14. # 创建标签
  15. tag1 = Tag.objects.create(name='Web Development')
  16. tag2 = Tag.objects.create(name='Tutorial')
  18. # 创建文章
  19. post1 = Post.objects.create(
  20.     title='Getting Started with Django',
  21.     slug='getting-started-with-django',
  22.     author=user,
  23.     content='This is the content of the first post...',
  24.     publish=timezone.now() - datetime.timedelta(days=2),
  25.     status='published'
  26. )
  27. post1.categories.add(category1)
  28. post1.tags.add(tag1, tag2)
  30. post2 = Post.objects.create(
  31.     title='Python Best Practices',
  32.     slug='python-best-practices',
  33.     author=user,
  34.     content='This is the content of the second post...',
  35.     publish=timezone.now() - datetime.timedelta(days=1),
  36.     status='published'
  37. )
  38. post2.categories.add(category2)
  39. post2.tags.add(tag2)
  41. exit()
复制代码

11.2 运行开发服务器
  2. python manage.py runserver
复制代码

访问以下URL测试您的应用：

• http://127.0.0.1:8000/- 主页，显示文章列表
• http://127.0.0.1:8000/admin/- 管理界面
• http://127.0.0.1:8000/accounts/login/- 登录页面

12. 部署准备

12.1 收集静态文件

在生产环境中，需要将所有静态文件收集到一个目录中：
  2. python manage.py collectstatic
复制代码

12.2 设置环境变量

在生产环境中，不要将敏感信息（如数据库密码、密钥等）硬编码在settings.py中。可以使用环境变量或.env文件。

安装python-decouple：
  2. pip install python-decouple
复制代码

创建.env文件：
  2. DEBUG=False
  3. SECRET_KEY=your-secret-key-here
  4. DATABASE_URL=your-database-url-here
复制代码

在settings.py中使用环境变量：
  2. from decouple import config
  4. DEBUG = config('DEBUG', default=False, cast=bool)
  5. SECRET_KEY = config('SECRET_KEY')
  7. # 数据库配置
  8. DATABASES = {
  9.     'default': config('DATABASE_URL', cast='dj_database_url.parse')
  10. }
复制代码

12.3 生产环境设置

创建生产环境的设置文件myproject/settings_production.py：
  2. from .settings import *
  4. # 安全设置
  5. DEBUG = False
  6. ALLOWED_HOSTS = ['yourdomain.com', 'www.yourdomain.com']
  8. # 静态文件
  9. STATIC_ROOT = BASE_DIR / 'staticfiles'
  11. # 安全中间件
  12. SECURE_SSL_REDIRECT = True
  13. SESSION_COOKIE_SECURE = True
  14. CSRF_COOKIE_SECURE = True
  15. SECURE_BROWSER_XSS_FILTER = True
  16. SECURE_CONTENT_TYPE_NOSNIFF = True
  17. X_FRAME_OPTIONS = 'DENY'
复制代码

13. 常见问题和解决方案

13.1 模板未找到

问题：TemplateDoesNotExist错误。

解决方案：

1. 确保模板目录结构正确。
2. 检查settings.py中的TEMPLATES设置。
3. 确保应用已添加到INSTALLED_APPS中。

13.2 静态文件未加载

问题：CSS、JavaScript或图像文件未加载。

解决方案：

1. 确保在模板中正确使用了{% static %}标签。
2. 检查settings.py中的静态文件设置。
3. 运行python manage.py collectstatic收集静态文件。
4. 确保Web服务器配置正确处理静态文件。

13.3 数据库迁移问题

问题：迁移失败或出现错误。

解决方案：

1. 检查模型定义是否有语法错误。
2. 删除迁移文件并重新创建。
3. 使用python manage.py showmigrations检查迁移状态。
4. 使用python manage.py migrate --fake跳过有问题的迁移。

13.4 权限问题

问题：用户无法访问特定页面或功能。

解决方案：

1. 检查视图中的权限装饰器。
2. 确保用户具有所需的权限。
3. 检查模板中的条件显示逻辑。

14. 总结和进阶学习资源

通过本指南，您已经学习了如何从零开始创建一个完整的Django项目，包括环境设置、项目创建、应用开发、模型定义、视图和URL配置、模板系统、静态文件管理、用户认证系统以及部署准备。

14.1 进阶学习资源

1. 官方文档：https://docs.djangoproject.com/- Django官方文档是最全面、最权威的学习资源。
2. Django for Professionals：https://djangoforprofessionals.com/- 适合有一定基础的开发者，学习如何构建生产级Django应用。
3. Django for APIs：https://djangoforapis.com/- 学习如何使用Django构建RESTful API。
4. Test-Driven Development with Python：https://www.obeythetestinggoat.com/- 学习使用测试驱动开发方法构建Django应用。
5. Django REST Framework：https://www.django-rest-framework.org/- 学习使用Django REST框架构建Web API。
6. Django Girls Tutorial：https://tutorial.djangogirls.org/- 适合初学者的友好教程。

官方文档：https://docs.djangoproject.com/- Django官方文档是最全面、最权威的学习资源。

Django for Professionals：https://djangoforprofessionals.com/- 适合有一定基础的开发者，学习如何构建生产级Django应用。

Django for APIs：https://djangoforapis.com/- 学习如何使用Django构建RESTful API。

Test-Driven Development with Python：https://www.obeythetestinggoat.com/- 学习使用测试驱动开发方法构建Django应用。

Django REST Framework：https://www.django-rest-framework.org/- 学习使用Django REST框架构建Web API。

Django Girls Tutorial：https://tutorial.djangogirls.org/- 适合初学者的友好教程。

14.2 实践项目建议

1. 博客系统：扩展本指南中的博客应用，添加更多功能，如评论系统、标签云、搜索功能等。
2. 电子商务网站：构建一个完整的电子商务网站，包括产品目录、购物车、订单处理和支付集成。
3. 社交媒体应用：创建一个简单的社交媒体应用，包括用户个人资料、帖子、关注系统和通知。
4. 任务管理工具：开发一个类似Trello的任务管理工具，包括项目、任务列表、卡片和拖放功能。
5. 内容管理系统：构建一个自定义的内容管理系统，允许用户创建和管理不同类型的内容。

博客系统：扩展本指南中的博客应用，添加更多功能，如评论系统、标签云、搜索功能等。

电子商务网站：构建一个完整的电子商务网站，包括产品目录、购物车、订单处理和支付集成。

社交媒体应用：创建一个简单的社交媒体应用，包括用户个人资料、帖子、关注系统和通知。

任务管理工具：开发一个类似Trello的任务管理工具，包括项目、任务列表、卡片和拖放功能。

内容管理系统：构建一个自定义的内容管理系统，允许用户创建和管理不同类型的内容。

通过不断实践和学习，您将能够掌握Django框架，并利用它构建高效、稳定的Web应用程序。祝您在Django开发之旅中取得成功！
初学者, 企业级
「七転び八起き（ななころびやおき）」
回复

使用道具 举报

返回列表 发新帖
您需要登录后才可以回帖 登录 | 立即注册
高级模式
B Color Image Link Quote Code Smilies

本版积分规则

关闭

站长推荐上一条 /1 下一条

友情链接

keba
磕巴白菜
别管 别听 就是玩
二次元论坛
二次元论坛
按下F逃离世界！
友链交换
友链交换
友链为随机排序，不代表本论坛观点
Telegram

Telegram

Discord

Discord

Tencent QQ

Tencent QQ

手机版|联系我们|小黑屋|TG频道|RSS |网站地图

Powered by Pixtech

© 2025-2026 Pixtech Team.

>