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

相关推荐
晓龙的Coding之路17 小时前
python celery框架结合django的使用
python·django·celery·celery cron·celery配置
星空2 天前
从 Python 基础到 Django 实战 —— 数据类型驱动的 Web 开发之旅
python·django
星空2 天前
学习 Django 之前
python·django
小咕聊编程2 天前
【含文档+PPT+源码】基于大数据的交通流量预测系统
大数据·python·django
囚~徒~3 天前
django_rq
后端·python·django
麦麦大数据3 天前
vue+django农产品价格预测和推荐可视化系统[带知识图谱]
vue.js·python·django·知识图谱·推荐算法·价格预测·农业大数据
angelasp3 天前
在pycharm中创建Django项目并启动
ide·pycharm·django
noravinsc3 天前
django.db.models.query_utils.DeferredAttribute object
数据库·django·sqlite
xieyan08114 天前
Django的异步任务队列管理_Celery
django