software

第2部分：设置你的第一个 Django 项目

发布: (2025年12月10日 GMT+8 02:55)
6 min read
原文: Dev.to

Source: Dev.to

这是系列 “通过构建社交媒体应用学习后端开发” 的第 2 部分。

欢迎回来！在前一部分，你了解了后端到底是什么以及它如何在现代应用中悄悄驱动几乎所有功能。现在是时候迈出第一步：在自己的电脑上创建后端项目。

阅读完本章节后，你将在机器上拥有一个运行中的 Django 项目。当浏览器窗口第一次打开并且后端响应时，旅程才真正开始。

理解我们即将安装的工具

Python

Python 是 Django 运行的语言。把它想象成配方中的基础原料——没有它，任何东西都无法工作。

Django

Django 是帮助你快速创建网站和后端的框架。它提供结构、工具以及许多内置功能。

Django REST Framework (DRF)

DRF 是 Django 的一个插件，帮助你构建 API，使你的应用（Android、iOS、Web）能够轻松与后端通信。
今天我们不安装 DRF；先从 Django 开始，后续章节再加入 DRF。

安装 Django 时会发生什么？

当你安装 Django 时，电脑会得到一个装满以下工具的工具箱：

  • 与数据库交互的工具
  • 管理用户的工具
  • 构建 URL 的工具
  • 创建模型的工具
  • 渲染数据的工具
  • 验证信息的工具
  • 构建整个项目结构的工具

Django 就像一个井然有序的厨房：每件事都有其用途，绝不随意。

步骤 1：安装 Python

如果你已经有 Python 3.10 或更高版本，直接使用即可。否则请从 python.org 下载。

Windows： 安装时务必勾选 Add Python to PATH。

安装完成后，打开终端（命令提示符、PowerShell，或 macOS/Linux 终端），运行：

python --version

如果输出类似 Python 3.10 或 Python 3.11，说明已准备好。

步骤 2：创建项目文件夹

为你的后端项目选定位置并创建文件夹，例如：

mkdir social_media_backend
cd social_media_backend

在 VS Code 或你喜欢的编辑器中打开此文件夹。

步骤 3：创建虚拟环境

虚拟环境是一个与其他项目隔离的私有 Python 环境。

使用以下命令创建：

python -m venv venv

激活它：

  • Windows

    venv\Scripts\activate

  • macOS/Linux

    source venv/bin/activate

此时终端提示符前应出现 (venv) 前缀。

步骤 4：安装 Django

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

pip install django

确认安装：

django-admin --version

出现版本号即表示成功。

步骤 5：创建你的 Django 项目

在 social_media_backend 目录下执行：

django-admin startproject core .
  • django-admin – Django 的命令行工具
  • startproject – 创建新项目
  • core – 项目包的名称
  • . – 将文件创建在当前目录，而不是新建子文件夹

项目结构

执行完命令后，目录结构如下：

social_media_backend/
│
├── core/
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py
│   ├── asgi.py
│   └── wsgi.py
│
└── manage.py

理解 Django 项目结构

manage.py

项目的遥控器。用它启动服务器、执行迁移、创建应用以及运行自定义命令。

settings.py

配置 Django 的所有行为：数据库设置、已安装的应用、安全、认证等。

urls.py

将 URL 映射到相应的处理代码。

asgi.py 与 wsgi.py

将项目连接到 Web 服务器。暂时不需要编辑它们，但在部署时会非常重要。

步骤 6：首次运行后端

启动开发服务器：

python manage.py runserver

你会看到类似以下的输出：

Starting development server at http://127.0.0.1:8000/

打开浏览器访问 http://127.0.0.1:8000/。你应该能看到 Django 的欢迎页面。

Django 欢迎页面

此时你的后端已经活跃——你的后端开发之旅正式开启。

一个简易示意图：你现在的项目

系统流程图

以后你将构建的所有功能——登录、帖子、通知、故事——都将从这个简单的运行服务器开始。

第 3 部分的后续内容

项目已经创建并运行后，接下来要了解用户。在第 3 部分我们将讨论：

  • 数据库的工作原理
  • 什么是模型
  • Django 如何存储数据
  • 设计自定义用户模型
  • 注册用户

敬请期待！

Back to Blog

相关文章

阅读更多 »