环境搭建：开启 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 。