1. Django 开发环境配置与项目初始化
1.1 Python 环境搭建
作为 Django 开发的基础,Python 环境的正确配置至关重要。我推荐使用 Python 3.11 版本,这是目前 Django 4.2 官方支持的最新稳定版本之一。
在 Ubuntu 系统上配置 Python 环境的完整步骤如下:
bash复制# 添加 deadsnakes PPA 源(包含多个 Python 版本)
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
# 安装 Python 3.11 及必要组件
sudo apt install python3.11 python3.11-venv python3.11-dev
# 验证安装
python3.11 --version
提示:python3.11-venv 包提供了虚拟环境支持,python3.11-dev 包含开发所需的头文件和静态库。在生产环境中,这些组件都是必需的。
1.2 项目虚拟环境创建
虚拟环境是 Python 项目管理的标准做法,它能有效隔离不同项目的依赖关系。我习惯在项目根目录下创建名为 .venv 的虚拟环境:
bash复制cd /path/to/your/project
python3.11 -m venv .venv
激活虚拟环境的方法:
bash复制source .venv/bin/activate # Linux/macOS
.venv\Scripts\activate # Windows
激活后,终端提示符前会出现 (.venv) 标记,表示当前处于虚拟环境中。
1.3 依赖管理实践
在虚拟环境中安装 Django 及其他依赖:
bash复制# 更新 pip 工具
python -m pip install --upgrade pip
# 安装 Django 4.2.x 系列最新版本
pip install django~=4.2.0
# 安装代码格式化工具(开发用)
pip install black
依赖管理的两个重要命令:
bash复制# 生成 requirements.txt
pip freeze > requirements.txt
# 根据 requirements.txt 安装依赖
pip install -r requirements.txt
经验分享:我习惯在项目根目录下维护 requirements.txt 文件,并在每次添加新依赖后立即更新它。这能确保团队协作时环境的一致性。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Django 项目创建与基础配置
2.1 项目初始化
使用 django-admin 创建新项目时,我推荐在项目目录下直接初始化(注意末尾的点):
bash复制django-admin startproject learn_django .
这种做法的好处是:
- 项目文件直接生成在当前目录,结构更清晰
- 避免了嵌套的项目目录结构
- 便于后续部署配置
2.2 数据库配置
Django 默认使用 SQLite 数据库,适合开发环境。初始化数据库的命令:
bash复制python manage.py migrate
对于生产环境,我强烈推荐使用 PostgreSQL。在 settings.py 中配置数据库:
python复制DATABASES = {
"default": {
"ENGINE": "django.db.backends.sqlite3",
"NAME": BASE_DIR / "db.sqlite3",
}
}
2.3 环境变量管理
使用 environs 包管理敏感配置是行业最佳实践:
bash复制pip install "environs[django]"
创建 .env 文件示例:
code复制DATABASE_URL=postgres://user:password@localhost:5432/dbname
DEBUG=False
SECRET_KEY=your-secret-key
ALLOWED_HOSTS=yourdomain.com
CSRF_TRUSTED_ORIGINS=http://yourdomain.com
对应的 settings
