夜雨聆风
可添加微信（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
📌 创建超级管理员
登录 Django 后台用：
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
