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

相关推荐
Wonderful U17 小时前
基于 Django Channels 与 WebSocket 的实时聊天室:群聊、私聊、离线消息与持久化存储全实现
python·websocket·django
Wonderful U17 小时前
Python+Django实战|校园二手闲置交易平台:从实名认证到交易闭环的完整校园电商解决方案
开发语言·python·django
Dxy12393102161 天前
Django 数据库 ENGINE 完全指南:选错了,性能差 10 倍
python·django
Wonderful U2 天前
基于Python+Django的在线题库与智能阅卷系统:从痛点分析到完整实现
开发语言·python·django
Wonderful U2 天前
基于Python爬虫+Django的轻量化天气预报系统:从数据抓取到可视化展示的完整实战
爬虫·python·django
俊哥工具2 天前
不用打开文件也能预览!支持压缩包、PDF、音视频
python·智能手机·django·pdf·计算机外设·virtualenv
Dxy12393102162 天前
Django 三种 ENGINE 的区别
python·django·sqlite
weixin_BYSJ19873 天前
springboot旅游管理系统04470(附源码+开发文档+部署教程)
java·spring boot·python·算法·django·flask·旅游
Wonderful U3 天前
基于Python+Django的私有化云笔记系统:从痛点分析到完整实现
笔记·python·django
Dxy12393102163 天前
Django 模型查询中的数据库连接池配置指南
数据库·django·sqlite