Django安装与首次运行—10分钟零门槛教程

可添加微信（ID：bader_guy，文末有二维码）获取指导，10元起

刚接触 Python Web 开发的小伙伴，大概率都会优先选择 Django 这个全能型框架 —— 自带后台、数据库、认证系统，开箱即用，新手也能快速搭建起可用的 Web 项目。

今天就带大家零门槛完成 Django 的安装和首次运行，全程跟着敲命令，10 分钟就能看到运行成功的页面！

💡 温馨提示：

操作前请确保你的电脑已安装 Python 3.8 及以上版本（Django 4.x/5.x 推荐搭配 Python 3.8+），并配置好环境变量。

一、前置准备：创建虚拟环境

新手一定要养成虚拟环境开发的习惯！它能隔离不同项目的依赖包，避免版本冲突，这也是企业开发的标准规范。

我们用 virtualenv 工具创建虚拟环境，一行行复制执行即可：

1️⃣ 安装虚拟环境工具

# 全局安装virtualenv（仅第一次使用时安装，后续无需重复）

pip install virtualenv

2️⃣ 创建虚拟环境

找一个空文件夹（建议纯英文路径，不要有中文、空格），打开命令行，执行：

# 创建名为 venv 的虚拟环境（文件夹名可自定义，比如env、django-env）

virtualenv venv

执行后，文件夹里会多出一个 venv 目录，这就是虚拟环境的专属文件。

3️⃣ 激活虚拟环境

不同系统激活命令不一样，别敲错啦：

# Windows系统（cmd命令行）

venv\Scripts\activate

# Windows系统（PowerShell）

.\venv\Scripts\Activate.ps1

# Mac/Linux系统

source venv/bin/activate

✅ 激活成功后，命令行开头会出现 (venv) 标识，说明虚拟环境已启用！

二、安装 Django

虚拟环境激活后，直接执行一行命令，就能安装最新稳定版 Django：

# 安装最新版Django

pip install django

# 如需指定版本（比如企业常用的4.2 LTS版），用这个命令

# pip install django==4.2

✅ 验证安装是否成功：执行以下命令，能看到版本号就说明安装完成！

django-admin --version

三、快速创建 Django 项目

Django 提供了一键生成项目骨架的命令，无需手动建文件：

# 创建名为 my_site 的Django项目（项目名可自定义，比如myblog、demo）

django-admin startproject my_site

执行后，会生成一个 my_site 文件夹，这就是你的项目根目录，默认结构如下：

my_site/

├── my_site/ # 项目核心配置目录

│ ├── __init__.py

│ ├── settings.py # 项目配置文件（核心！）

│ ├── urls.py # 路由配置文件

│ ├── asgi.py

│ └── wsgi.py

└── manage.py # Django项目命令行工具（启动、迁移数据库全靠它）

四、启动项目：本地访问 Django 页面

最后一步，启动 Django 内置的开发服务器，就能在浏览器看到效果啦！

1️⃣ 进入项目目录

cd my_site

2️⃣ 初始化数据库（必做）

Django 自带用户、会话等系统，需要先同步数据库表：

python manage.py migrate

3️⃣ 启动开发服务器

python manage.py runserver

启动成功后，命令行会提示：Starting development server at http://127.0.0.1:8000/

🎉 打开浏览器，输入地址 http://127.0.0.1:8000/

看到 Django 的小火箭欢迎页面，就说明成功运行啦！

五、常用补充命令（新手收藏）

📌 退出虚拟环境

所有系统通用，直接执行：

deactivate

📌 修改启动端口

默认 8000 端口被占用时用：

python manage.py runserver 8080

📌 创建超级管理员

python manage.py createsuperuser

六、常见小问题（避坑指南）

❓ 命令行提示 "django-admin 不是内部命令"

👉 Python 环境变量未配置，或虚拟环境未激活。

❓ 启动后无法访问

👉 检查端口是否被占用，换 8080 等端口重试。

❓ Windows PowerShell 激活虚拟环境报错

👉 以管理员身份打开 PowerShell，执行 Set-ExecutionPolicy RemoteSigned 授权即可。

📝 总结

✅ 新手必用虚拟环境，避免依赖冲突

✅ 核心命令：pip install django → django-admin startproject → python manage.py runserver

✅ 访问地址：http://127.0.0.1:8000/，看到小火箭即成功

按照这个步骤，零基础也能轻松跑通 Django 第一个项目，接下来就可以开始学习路由、视图、模板啦！

获取帮助，可添加微信ID：bader_guy