一、环境准备

1、Python版本要求

• 已安装Python 3.10.11（可通过python --version验证）
• 确保pip包管理器可用（pip --version）

2、虚拟环境创建

# 创建项目目录
mkdir mydjango_project
cd mydjango_project

# 创建虚拟环境
python -m venv venv

# 激活虚拟环境
# Windows系统:
venv\Scripts\activate
# Linux/Mac系统:
source venv/bin/activate

二、Django安装与项目创建

1、 安装Django

pip install django==4.2  # 推荐使用LTS版本

2、创建项目

django-admin startproject config .

目录结构说明：

mydjango_project/
├── config/              # 项目配置目录
│   ├── __init__.py
│   ├── settings.py      # 核心配置文件
│   ├── urls.py          # 主URL配置
│   ├── wsgi.py
│   └── asgi.py
├── manage.py            # 项目管理脚本
└── db.sqlite3           # SQLite数据库文件（自动生成）

三、数据库配置（默认SQLite）

1、 验证数据库配置
打开config/settings.py，确认以下配置：

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

2、初始化数据库

# 执行迁移创建默认表
python manage.py migrate

# 创建超级用户（可选）
python manage.py createsuperuser

四、基础应用创建

1、 创建示例应用

python manage.py startapp core

2、 注册应用
在config/settings.py的INSTALLED_APPS中添加：

INSTALLED_APPS = [
    # ... 默认应用
    'core',  # 新增应用
]

五、开发服务器配置

1、 启动开发服务器

python manage.py runserver

访问http://127.0.0.1:8000/admin验证安装
2、 关键配置项
在config/settings.py中确认：

# 开发环境配置
DEBUG = True
ALLOWED_HOSTS = ['localhost', '127.0.0.1']

# 时区配置
TIME_ZONE = 'Asia/Shanghai'
USE_TZ = False

六、验证安装

1、 创建测试视图
在core/views.py中添加：

from django.http import HttpResponse

def index(request):
    return HttpResponse("Django项目初始化成功！")

2、 配置URL路由
在config/urls.py中添加：

from django.contrib import admin
from django.urls import path
from core import views

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', views.index, name='index'),
]

3、 访问测试
重启服务器后访问http://127.0.0.1:8000/，应显示" Django项目初始化成功！"

七、开发环境检查清单

• Python 3.10.11环境正常
• 虚拟环境已激活
• Django 4.2 LTS版本安装
• SQLite数据库文件生成
• 默认数据表迁移完成
• 开发服务器可正常启动
• 管理后台可访问

八、常见问题处理

1、端口占用

# 更换端口启动
python manage.py runserver 8080

2、 权限问题

# Linux/Mac系统赋予执行权限
chmod +x manage.py

3、 数据库重置

# 删除数据库文件后重新迁移
rm db.sqlite3
python manage.py migrate