通过在命令提示行输入命令(由 $ 前缀)。
$ python -m django --version
如果这行命令输出了一个版本号,证明你已经安装了此版本的 Django;如果你得到的是一个“No module named django”的错误提示,则表明你还未安装。
本教程是为Django 4.0 编写的,它支持 Python 3.8 及以后的版本。如果 Django 版本不匹配,你可以通过本页右下角的版本切换器改到你的 Django 版本的教程,或者将 Django 更新到最新的版本。
创建项目
如果这是你第一次使用 Django 的话,你需要一些初始化设置。也就是说,你需要用一些自动生成的代码配置一个 Django
打开命令行,cd
到一个你想放置你代码的目录,然后运行以下命令:
project —— 即一个 Django 项目实例需要的设置项集合,包括数据库配置、Django 配置和应用程序配置。
django-admin startproject mysite
这行代码将会在当前目录下创建一个 mysite
目录。如果命令失败了,查看 运行 django-admin 时遇到的问题,可能能给你提供帮助。
mysite/
manage.py
mysite/
__init__.py
settings.py
urls.py
asgi.py
wsgi.py
这些目录和文件的用处是:
- 最外层的 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服务器上的入口。