Python Web框架Django怎么安装和配置

发布时间：2021-11-25 13:49:42 作者：iii
来源：亿速云阅读：203

# Python Web框架Django怎么安装和配置

## 一、Django简介

Django是一个高级Python Web框架，由经验丰富的开发者构建，旨在帮助开发者快速构建高效、安全的Web应用程序。它遵循"Don't Repeat Yourself"（DRY）原则，提供了一套完整的工具和库，使开发者能够专注于应用程序的逻辑而不是重复的底层代码。

主要特点：
- 强大的ORM（对象关系映射）
- 自动化的管理后台
- 完善的URL路由系统
- 模板引擎
- 内置的安全防护
- 出色的文档和活跃的社区

## 二、安装前的准备工作

### 1. 检查Python版本
Django需要Python 3.6或更高版本。在终端运行以下命令检查Python版本：

```bash
python --version
# 或
python3 --version

如果未安装Python或版本过低，请先安装最新版本的Python。

2. 创建虚拟环境（推荐）

强烈建议使用虚拟环境来隔离项目依赖：

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

# 激活虚拟环境
# Windows:
myenv\Scripts\activate
# macOS/Linux:
source myenv/bin/activate

三、安装Django

1. 使用pip安装

在激活的虚拟环境中运行：

pip install django

这将安装最新稳定版的Django。

2. 验证安装

安装完成后，验证是否成功：

python -m django --version

如果显示版本号（如4.2.x），说明安装成功。

3. 安装特定版本（可选）

如果需要特定版本：

pip install django==4.2.3

四、创建Django项目

1. 初始化项目

运行以下命令创建新项目：

django-admin startproject myproject

这将创建名为”myproject”的目录，包含基本项目结构。

2. 项目目录结构

初始项目包含以下关键文件：

myproject/
    manage.py
    myproject/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py

manage.py: 项目管理脚本
settings.py: 项目配置文件
urls.py: URL路由配置

五、基本配置

1. 数据库配置

默认使用SQLite，如需更改（如PostgreSQL/MySQL），修改settings.py:

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'mydatabase',
        'USER': 'mydatabaseuser',
        'PASSWORD': 'mypassword',
        'HOST': '127.0.0.1',
        'PORT': '5432',
    }
}

2. 时区和语言设置

修改settings.py:

LANGUAGE_CODE = 'zh-hans'  # 中文
TIME_ZONE = 'Asia/Shanghai'  # 上海时区

3. 静态文件配置

添加静态文件设置：

STATIC_URL = 'static/'
STATICFILES_DIRS = [BASE_DIR / "static"]  # 开发环境
STATIC_ROOT = BASE_DIR / "staticfiles"  # 生产环境收集静态文件

六、运行开发服务器

1. 启动服务器

在项目根目录运行：

python manage.py runserver

默认访问地址：http://127.0.0.1:8000

2. 自定义端口

指定端口号运行：

python manage.py runserver 8080

七、创建应用

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

python manage.py startapp myapp

应用目录结构

新应用包含：

myapp/
    __init__.py
    admin.py
    apps.py
    migrations/
    models.py
    tests.py
    views.py

注册应用

在settings.py的INSTALLED_APPS中添加：

INSTALLED_APPS = [
    ...
    'myapp',
]

八、数据库迁移

1. 创建迁移文件

Django自带一些内置应用需要数据库表：

python manage.py makemigrations

2. 应用迁移

执行迁移命令：

python manage.py migrate

九、创建管理员用户

1. 创建超级用户

运行以下命令：

python manage.py createsuperuser

按提示输入用户名、邮箱和密码。

2. 访问管理后台

启动服务器后访问：http://127.0.0.1:8000/admin

十、项目结构优化（可选）

1. 拆分settings.py

为不同环境创建配置：

myproject/
    settings/
        __init__.py
        base.py
        development.py
        production.py

2. 环境变量管理

使用python-dotenv管理敏感信息：

pip install python-dotenv

创建.env文件：

SECRET_KEY=your_secret_key_here
DEBUG=True

在settings.py中读取：

from dotenv import load_dotenv
load_dotenv()

SECRET_KEY = os.getenv('SECRET_KEY')

十一、常见问题解决

1. 端口冲突

如果端口被占用，可以： - 终止占用进程 - 使用其他端口

2. 数据库连接错误

检查： - 数据库服务是否运行 - 配置信息是否正确 - 用户权限是否足够

3. 静态文件404

确保： - DEBUG=True（开发环境） - 正确配置了STATIC_URL和STATICFILES_DIRS

十二、生产环境部署准备

1. 关闭调试模式