📚 课程目录第1章搭建开发环境与项目结构

1. 搭建开发环境与项目结构

任务说明

本案例目标是在本机完成一个Python全栈开发的基础环境搭建：创建独立虚拟环境、安装Flask与Django框架、建立规范的项目目录结构，并初始化Git仓库。完成后，你将拥有一个可直接开始后续开发的基础工程骨架。

环境准备与虚拟环境创建

首先确认本机已安装Python 3.9+与Git。在终端中执行以下命令创建项目根目录并进入：

mkdir python-fullstack-dev
cd python-fullstack-dev

创建虚拟环境（使用Python内置的venv模块，无需额外安装）：

python3 -m venv venv

激活虚拟环境：

macOS/Linux: source venv/bin/activate
Windows: venv\Scripts\activate

激活后，终端提示符前会出现(venv)前缀，表示当前已处于虚拟环境中。后续所有依赖安装与命令执行均在此环境下进行。

安装Flask与Django

在已激活的虚拟环境中，使用pip安装指定框架版本（为保证可复现性，这里固定版本）：

pip install flask==3.0.3 django==5.0.6

安装完成后，生成依赖清单文件，便于他人或后续环境重建：

pip freeze > requirements.txt

创建项目目录结构

按照全栈开发常见分层，创建以下目录结构。其中backend存放Django服务端代码，frontend预留前端工程，docs存放文档，scripts存放辅助脚本：

mkdir -p backend frontend docs scripts
touch backend/__init__.py frontend/.gitkeep docs/.gitkeep scripts/.gitkeep

此时项目根目录结构如下：

python-fullstack-dev/
├── backend/
│   └── __init__.py
├── frontend/
│   └── .gitkeep
├── docs/
│   └── .gitkeep
├── scripts/
│   └── .gitkeep
├── venv/                # 虚拟环境（不纳入版本控制）
├── requirements.txt
└── .gitignore

配置.gitignore与初始化Git仓库

创建.gitignore文件，排除虚拟环境、缓存与临时文件：

# Python
__pycache__/
*.py[cod]
*.so
.Python

# 虚拟环境
venv/
env/

# 环境变量与本地配置
.env
*.local

# IDE
.idea/
.vscode/
*.swp

# 系统文件
.DS_Store
Thumbs.db

# 数据库与日志
*.sqlite3
*.log

初始化Git仓库并完成首次提交：

git init
git add .
git commit -m "初始化项目结构：配置虚拟环境，安装Flask与Django"

验证方法与判定标准

完成上述步骤后，按以下顺序验证环境是否搭建成功：

虚拟环境验证：执行which python（Windows为where python），路径应指向当前项目下的venv/bin/python或venv\Scripts\python.exe。
框架安装验证：在终端执行python -c "import flask, django; print(flask.__version__, django.get_version())"，预期输出为3.0.3 5.0.6（与安装版本一致）。
Git状态验证：执行git status，应显示工作区干净（无未提交变更）；执行git log --oneline，应看到一条提交记录，信息为“初始化项目结构：配置虚拟环境，安装Flask与Django”。
目录结构验证：执行ls -la（Windows为dir），确认backend、frontend、docs、scripts目录及requirements.txt、.gitignore文件均存在。

以上4项全部通过，即表示当前案例目标已达成。后续开发中，每次进入项目需先执行虚拟环境激活命令。