环境信息
- 操作系统:Windows 11 x64
- Python 版本:3.11
一、安装 Django
安装步骤非常简单,使用 pip 安装即可。
pip install django
安装完成后,Python 的 Scripts 文件夹下会多一个 django-admin.exe(管理创建 Django 项目的工具),Lib 文件夹下的 site-packages 下会出现 Django 源码。使用下面的命令可以查看 Django 版本号。
python -m django --version
显示:
5.0.1
二、创建与开发 Web 项目
这里记录两种创建方式,一种是命令行方式创建,一种是通过 PyCharm 方式创建。
1.1 通过命令行方式
打开终端,进入到项目将要放在的目录下,执行创建项目命令:
django-admin startproject <项目名称>
如果提示没有这个命令,有可能是没有配置环境变量,将 django-admin 的存放路径加入系统变量就可以了。
1.2 通过 PyCharm 创建项目
打开 PyCharm,左上角'文件','新建项目',左侧选择 Django,配置项目位置、Python 解析器后点击创建。
最顶上的【名称】与【位置】是项目名称与项目的存放位置。请确认使用的 Python 版本,尤其是当电脑里存在多个 Python 脚本时,一定要选择安装了 Django 的那个 Python 版本。如果电脑里只有一个 Python 版本,就不需要改动。在下面添加模板文件和【APP】名称,点击【创建】完成创建。注意区分以下两个文件夹名字,之后会用到。
创建完成后,可以看到创建了很多文件,这些都是 Django 项目的必备文件。以下是官方解释:
- 最外层的
mysite/根目录只是你项目的容器,根目录名称对 Django 没有影响,你可以将它重命名为任何你喜欢的名称。 manage.py: 一个让你用各种方式管理 Django 项目的命令行工具。- 里面一层的
mysite/目录包含你的项目,它是一个纯 Python 包。它的名字就是当你引用它内部任何东西时需要用到的 Python 包名(比如mysite.urls)。 mysite/__init__.py: 一个空文件,告诉 Python 这个目录应该被认为是一个 Python 包。mysite/settings.py: Django 项目的配置文件。mysite/urls.py: Django 项目的 URL 声明,就像你网站的'目录'。mysite/asgi.py: 作为你的项目的运行在 ASGI 兼容的 Web 服务器上的入口。mysite/wsgi.py: 作为你的项目的运行在 WSGI 兼容的 Web 服务器上的入口。
到此,项目创建完成,可以简单运行一下。PyCharm 里点击绿色三角形自动开启 Web 服务。如果是命令行创建的,则在项目的根目录下,打开终端,运行:
python manage.py runserver localhost:8000
然后打开浏览器,输入网址:
http://127.0.0.1:8000/admin
可以看到 Admin 后台的登录页面。
下面是 Django 的官方文档,里面记载了 Django 的所有详细介绍:
https:

