编辑“︁Django安装配置”︁

= Django安装配置 =

== 简介 ==
Django是一个高级Python Web框架，遵循"快速开发"和"DRY(Don't Repeat Yourself)"原则。在开始使用Django开发Web应用前，正确的安装和配置是至关重要的第一步。本节将详细介绍如何在不同操作系统上安装Django，并配置开发环境。

== 系统要求 ==
Django支持以下Python版本：
* Python 3.8
* Python 3.9
* Python 3.10
* Python 3.11

推荐使用最新稳定版的Python和Django以获得最佳性能和安全性。

== 安装步骤 ==

=== 1. 安装Python ===
Django需要Python环境，首先确保系统已安装Python。

在终端/命令行中检查Python版本：
<syntaxhighlight lang="bash">
python --version
# 或
python3 --version
</syntaxhighlight>

如果未安装Python，请从[https://www.python.org/downloads/ Python官网]下载并安装。

=== 2. 创建虚拟环境 ===
推荐使用虚拟环境隔离项目依赖：
<syntaxhighlight lang="bash">
# 创建项目目录
mkdir mydjango_project
cd mydjango_project

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

# 激活虚拟环境
# Windows:
venv\Scripts\activate
# Unix/macOS:
source venv/bin/activate
</syntaxhighlight>

=== 3. 安装Django ===
在激活的虚拟环境中安装Django：
<syntaxhighlight lang="bash">
pip install django
</syntaxhighlight>

安装特定版本：
<syntaxhighlight lang="bash">
pip install django==4.2.3
</syntaxhighlight>

验证安装：
<syntaxhighlight lang="bash">
python -m django --version
</syntaxhighlight>

== 配置开发环境 ==

=== 1. 创建Django项目 ===
<syntaxhighlight lang="bash">
django-admin startproject mysite
</syntaxhighlight>

这会创建如下目录结构：
<pre>
mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py
</pre>

=== 2. 配置数据库 ===
Django默认使用SQLite数据库，无需额外配置。如需使用其他数据库，修改settings.py：
<syntaxhighlight lang="python">
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': 'mydatabase',
        'USER': 'mydatabaseuser',
        'PASSWORD': 'mypassword',
        'HOST': '127.0.0.1',
        'PORT': '5432',
    }
}
</syntaxhighlight>

=== 3. 运行开发服务器 ===
<syntaxhighlight lang="bash">
python manage.py runserver
</syntaxhighlight>

访问[http://127.0.0.1:8000/](http://127.0.0.1:8000/)将看到Django欢迎页面。

== 高级配置 ==

=== 多环境配置 ===
使用不同的settings文件管理开发和生产环境：
<pre>
mysite/
    settings/
        __init__.py
        base.py      # 通用配置
        dev.py       # 开发环境
        prod.py      # 生产环境
</pre>

运行指定配置：
<syntaxhighlight lang="bash">
python manage.py runserver --settings=mysite.settings.dev
</syntaxhighlight>

=== 环境变量管理 ===
使用python-dotenv管理敏感信息：
1. 安装包：
<syntaxhighlight lang="bash">
pip install python-dotenv
</syntaxhighlight>

2. 创建.env文件：
<pre>
SECRET_KEY=your_secret_key_here
DEBUG=True
</pre>

3. 在settings.py中：
<syntaxhighlight lang="python">
from dotenv import load_dotenv
load_dotenv()

SECRET_KEY = os.getenv('SECRET_KEY')
DEBUG = os.getenv('DEBUG') == 'True'
</syntaxhighlight>

== 常见问题 ==

=== 1. 安装失败 ===
可能原因：
* Python版本不兼容
* 网络问题
* 权限不足（尝试添加--user选项）

解决方案：
<syntaxhighlight lang="bash">
python -m pip install --upgrade pip
pip install django --user
</syntaxhighlight>

=== 2. 端口冲突 ===
如果8000端口被占用：
<syntaxhighlight lang="bash">
python manage.py runserver 8080
</syntaxhighlight>

=== 3. 数据库连接问题 ===
确保：
* 数据库服务正在运行
* 配置信息正确
* 已安装数据库适配器（如psycopg2用于PostgreSQL）

== 实际案例 ==

假设我们要开发一个博客系统，安装配置步骤如下：

1. 创建项目目录：
<syntaxhighlight lang="bash">
mkdir myblog && cd myblog
</syntaxhighlight>

2. 设置虚拟环境并安装Django：
<syntaxhighlight lang="bash">
python -m venv venv
source venv/bin/activate
pip install django
</syntaxhighlight>

3. 创建项目和应用：
<syntaxhighlight lang="bash">
django-admin startproject blog_project
cd blog_project
python manage.py startapp blog
</syntaxhighlight>

4. 配置INSTALLED_APPS（在settings.py中）：
<syntaxhighlight lang="python">
INSTALLED_APPS = [
    ...,
    'blog',
]
</syntaxhighlight>

5. 运行开发服务器：
<syntaxhighlight lang="bash">
python manage.py runserver
</syntaxhighlight>

== 总结 ==
正确的Django安装和配置是开发Web应用的基础。通过虚拟环境隔离项目依赖，合理配置不同环境设置，并使用环境变量管理敏感信息，可以建立健壮的开发环境。随着项目复杂度增加，可以考虑使用更专业的配置管理工具如Docker。

<mermaid>
graph TD
    A[安装Python] --> B[创建虚拟环境]
    B --> C[安装Django]
    C --> D[创建项目]
    D --> E[配置数据库]
    E --> F[运行服务器]
</mermaid>

下一步学习：[[Django项目结构解析]]

[[Category:后端框架]]
[[Category:Django]]
[[Category:Django基础]]