如何创建一个django项目

发布时间：2021-10-21 15:15:17 作者：柒染
来源：亿速云阅读：257

# 如何创建一个Django项目

Django是一个功能强大的Python Web框架，以其"开箱即用"的特性和清晰的MVC（模型-视图-控制器）架构而闻名。本文将详细介绍从零开始创建Django项目的完整流程。

## 一、环境准备

### 1. 安装Python
Django基于Python运行，因此需要先安装Python环境：
```bash
# 检查Python版本（需要3.6+）
python --version

推荐使用虚拟环境隔离项目依赖：

python -m venv myenv      # 创建虚拟环境
source myenv/bin/activate # 激活环境（Linux/Mac）
myenv\Scripts\activate    # Windows系统

2. 安装Django

使用pip安装最新稳定版：

pip install django
# 验证安装
python -m django --version

二、创建项目骨架

1. 初始化项目

django-admin startproject mysite

这会生成以下目录结构：

mysite/
    manage.py         # 项目管理脚本
    mysite/           # 项目主目录
        __init__.py
        settings.py   # 全局配置
        urls.py      # 主路由配置
        asgi.py      # ASGI配置
        wsgi.py      # WSGI配置

2. 运行开发服务器

python manage.py runserver

访问http://127.0.0.1:8000将看到欢迎页面。

三、项目配置

1. 基础设置

修改settings.py关键配置：

# 时区设置
TIME_ZONE = 'Asia/Shanghai'
# 语言设置
LANGUAGE_CODE = 'zh-hans'
# 允许的域名
ALLOWED_HOSTS = ['*']  # 开发时可临时设为*

2. 数据库配置

默认使用SQLite：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db.sqlite3',
    }
}

如需使用MySQL：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'mydatabase',
        'USER': 'root',
        'PASSWORD': 'mypassword',
        'HOST': 'localhost',
        'PORT': '3306',
    }
}

四、创建应用

Django项目由多个应用组成，创建第一个应用：

python manage.py startapp blog

目录结构新增：

blog/
    migrations/       # 数据库迁移文件
    __init__.py
    admin.py         # 管理后台配置
    apps.py          # 应用配置
    models.py        # 数据模型
    tests.py         # 测试用例
    views.py         # 视图逻辑

1. 注册应用

在settings.py中添加：

INSTALLED_APPS = [
    ...
    'blog.apps.BlogConfig',
]

2. 创建第一个视图

编辑blog/views.py：

from django.http import HttpResponse

def index(request):
    return HttpResponse("欢迎来到我的博客！")

3. 配置URL路由

在blog目录下创建urls.py：

from django.urls import path
from . import views

urlpatterns = [
    path('', views.index, name='index'),
]

然后在主urls.py中包含子路由：

from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path('admin/', admin.site.urls),
    path('blog/', include('blog.urls')),
]

五、数据库操作

1. 创建模型

编辑blog/models.py：

from django.db import models

class Post(models.Model):
    title = models.CharField(max_length=100)
    content = models.TextField()
    created_at = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.title

2. 生成迁移文件

python manage.py makemigrations
python manage.py migrate

3. 使用Django Shell

python manage.py shell

>>> from blog.models import Post
>>> Post.objects.create(title="第一篇", content="这是内容")

六、管理后台

1. 创建超级用户

python manage.py createsuperuser

2. 注册模型

编辑blog/admin.py：

from django.contrib import admin
from .models import Post

admin.site.register(Post)

访问/admin即可管理数据。

七、模板系统

1. 创建模板目录

在blog下新建templates/blog目录

2. 创建模板文件

index.html示例：

<!DOCTYPE html>
<html>
<head>
    <title>我的博客</title>
</head>
<body>
    {% for post in posts %}
    <h2>{{ post.title }}</h2>
    <p>{{ post.content }}</p>
    {% endfor %}
</body>
</html>

3. 修改视图

from django.shortcuts import render
from .models import Post

def index(request):
    posts = Post.objects.all()
    return render(request, 'blog/index.html', {'posts': posts})

八、项目部署准备

1. 收集静态文件

python manage.py collectstatic

2. 生产环境设置

创建production.py：

from .settings import *

DEBUG = False
ALLOWED_HOSTS = ['yourdomain.com']

常见问题解决

端口冲突：使用python manage.py runserver 8080指定端口
数据库连接错误：检查settings.py配置和数据库服务状态
模板找不到：确保settings.py中TEMPLATES的DIRS配置正确

通过以上步骤，你已经完成了一个基础Django项目的搭建。接下来可以继续开发更多功能，如用户认证、REST API等。

提示：使用python manage.py help可以查看所有可用命令。 “`