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

相关推荐
blues_C15 小时前
十三、【核心功能篇】测试计划管理:组织和编排测试用例
vue.js·django·测试用例·drf·测试平台
恸流失1 天前
DJango项目
后端·python·django
编程大全1 天前
41道Django高频题整理(附答案背诵版)
数据库·django·sqlite
网安小张1 天前
解锁FastAPI与MongoDB聚合管道的性能奥秘
数据库·python·django
KENYCHEN奉孝2 天前
Pandas和Django的示例Demo
python·django·pandas
老胖闲聊2 天前
Python Django完整教程与代码示例
数据库·python·django
noravinsc2 天前
django paramiko 跳转登录
后端·python·django
践行见远2 天前
django之请求处理过程分析
数据库·django·sqlite
声声codeGrandMaster2 天前
Django之表格上传
后端·python·django
菌菌的快乐生活2 天前
网站静态文件加速-Django项目静态文件存储到腾讯云COS存储提升网络请求速度
django·cos存储