Django1：起步——安装、运行与项目结构

1. 我们要做一个什么样的博客

整个系列做同一个项目：一个个人博客。

每篇文章解决一个问题：

2. 两条路线，选一条

• 路线 A：从零创建。 适合想一步步看着项目长出来的读者。之后每篇按文章添加代码。
• 路线 B：直接运行完整示例。 适合想先看成品、再回头读原理的读者。下载本页顶部目录里的 ZIP 即可。

路线 A：从零创建最小项目

macOS / Linux：

python3 --version
mkdir django-blog
cd django-blog
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install 'Django>=5.2,<5.3'
python -m django --version
python -m django startproject config .
python manage.py startapp blog
python manage.py migrate
python manage.py runserver 127.0.0.1:8000

Windows PowerShell 把创建和激活环境换成：

py -3.12 -m venv .venv
.\.venv\Scripts\Activate.ps1

如果提示脚本被禁止运行，可以不激活，直接用 .\.venv\Scripts\python.exe 代替后面的 python。

逐条看看这些命令做了什么：

打开 http://127.0.0.1:8000/，看到 Django 的欢迎页就成功了。按 Ctrl+C 停止服务器。

路线 B：直接运行完整博客

解压示例 ZIP，进入其中的 django-series/example/ 目录（也就是 manage.py 所在目录）：

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python manage.py migrate
python manage.py createsuperuser
python manage.py runserver 127.0.0.1:8000

createsuperuser 会让你设置管理员的用户名、邮箱和密码。输入密码时屏幕不显示字符，这是正常的。

启动后逐个打开这些地址检查：

试着发第一篇文章： 登录 /admin/，新建分类“技术”和标签“Django”；回到网站首页点“写文章”，填写标题、英文网址标识（如 hello-django）和正文，状态选“已发布”，保存。回到首页就能看到它。

3. 项目里都有什么

Django 把网站分成两层：

• 项目（project）：一个能独立运行的网站，管全站配置。本例叫 config。
• 应用（app）：网站里一块相对独立的功能。本例的 blog 负责文章、分类、标签。以后加商城，就再建一个 shop 应用，不用新建项目。

django-blog/
├── manage.py            执行管理命令的入口
├── config/              项目：全站配置
│   ├── settings.py      所有配置项（第 2 篇）
│   ├── urls.py          总路由（第 2 篇）
│   ├── wsgi.py          部署时服务器加载应用的入口（第 8 篇）
│   └── asgi.py          异步部署入口，本系列不用
├── blog/                应用：博客功能
│   ├── models.py        数据模型（第 3 篇）
│   ├── views.py         处理请求（第 5、6 篇）
│   ├── urls.py          博客的路由（第 2 篇）
│   ├── forms.py         表单（第 6 篇）
│   ├── admin.py         后台配置（第 6 篇）
│   └── tests.py         测试（第 8 篇）
└── templates/           页面模板（第 5 篇）

后面每篇改哪个文件，看这张图就能找到。

4. 本地运行和正式上线有什么不同

runserver 只用于开发：它会自动重载代码、显示详细错误，但不是为公网流量设计的。正式上线时，请求会经过更多环节：

开发时：  浏览器 → runserver → Django → SQLite

上线后：  浏览器 → Nginx（HTTPS）→ Gunicorn → Django → PostgreSQL
                    └─ 直接提供 /static/ 下的 CSS、JS

现在只需要知道有这么一条链路。第 2–7 篇都在本地用 SQLite 开发；第 8 篇再完整讲容器化部署、HTTPS 和数据库切换。

5. 常见问题

小练习