环境搭建：开启 Django 开发之旅
一、环境搭建：开启 Django 开发之旅
（一）安装 Python
先确保电脑上装有 Python 3.6 及以上版本，Django 5.1 的话，至少得 Python 3.8+ 哦。
安装前，先查下有没有装过 Python ，终端（Windows 开 cmd，Mac/Linux 用终端）里敲：
bash
python --version
或者：
bash
python3 --version
要是有版本号，比如显示 Python 3.10.9 ，那恭喜你，省去这一步啦。
要是没装，或者版本太低，就去下载最新稳定版（推荐 Python 3.10+）。
安装时也很简单：
- Windows：运行安装包，勾上 "Add Python to PATH"，点 Next。
- Mac/Linux：通常用包管理器装，像 Homebrew 或 apt，或者直接下安装包。
装完再检查一遍，终端里再跑一遍 python --version ，看到版本号就说明成功啦。
（二）创建虚拟环境
这一步很关键，能帮你隔离项目依赖，避免把全局环境搞乱。
创建虚拟环境也很容易，用 Python 自带的 venv 模块就行，项目目录下（比如 myproject/）敲命令：
bash
python -m venv myenv
这里 myenv 是虚拟环境的文件夹名，你可以自己改名。
激活虚拟环境：
- Windows：
bash
myenv\Scripts\activate
- Linux/Mac：
bash
source myenv/bin/activate
激活后，终端提示符会带 (myenv)，这就说明进虚拟环境啦。
如果想退出虚拟环境，敲：
bash
deactivate
为啥要用虚拟环境呢？好处多着呢：
- 不同项目依赖冲突能避开，像一个项目要 Django 3.x，另一个要 Django 4.x，虚拟环境能轻松应对。
- 能保持全局 Python 环境干干净净。
（三）安装 Django
准备工作做好后，就能装 Django 啦。
先确保虚拟环境激活了（终端有 (myenv) ）。然后敲：
bash
pip install django
装完用这个命令验证下：
bash
django-admin --version
要是输出类似 5.1.4 ，就说明装好了。
安装过程可能会碰到问题：
- 权限问题：要是提示 Permission denied，Linux/Mac 上可以加 sudo 重试。
- 网络问题：pip 安装太慢，可以换国内镜像，比如清华源：
bash
pip install django -i https://pypi.tuna.tsinghua.edu.cn/simple
二、验证环境搭建
接下来验证环境是不是搭好了。
先创建 Django 项目，敲：
bash
django-admin startproject myproject
然后进项目目录：
bash
cd myproject
运行开发服务器：
bash
python manage.py runserver
浏览器打开本地服务器地址，要是看到 Django 默认页面，就说明环境搭好了，可以开始开发啦。
三、补充说明
（一）虚拟环境工具选择
- venv：Python 自带，简单项目够用了。
- virtualenv：功能多些，能自定义更多选项，不过得先装，命令是 pip install virtualenv。
（二）Django 版本兼容性
- Django 5.1 需要 Python 3.8+。
- 要是项目需要特定版本，比如 Django 3.2 ，可以用命令装：
bash
pip install django==3.2
（三）项目结构
用 startproject 创建的目录结构是这样的：
myproject/
├── manage.py
└── myproject/
├── __init__.py
├── settings.py
├── urls.py
└── wsgi.py
四、常见问题解答
Q1：装了 Python ，运行 python 命令没反应？
- 解决方法：
- 检查 Python 是否添加到系统 PATH。
- Windows 用户：重新运行安装包，勾选 "Add Python to PATH"。
- Mac/Linux 用户：手动加路径，比如 export PATH="/usr/local/bin/python3:$PATH"。
Q2：激活虚拟环境失败？
- 解决方法：
- 确保路径没错（Windows 是 myenv\Scripts\activate ，Linux/Mac 是 myenv/bin/activate ）。
- 如果提示 activate: No such file or directory ，可能是创建虚拟环境没成功，重新运行 python -m venv myenv 。
Q3：装了 Django ，却用不了 django-admin？
- 解决方法：
- 确保虚拟环境激活了。
- 要是还不行，试试用 python -m django --version 代替 django-admin 。