一、安装准备
首先,在 Windows 系统中安装 Django,这个过程会涉及使用命令提示符(CMD),这是 Windows 系统中用于执行命令的一个程序。我们将从最基础的操作开始:
步骤 1: 打开命令提示符
- 打开运行对话框:
- 按 Win+R 打开运行对话框。这里,Win 是键盘上带有 Windows 徽标的键。
- 启动命令提示符:
- 在运行对话框中输入 cmd 然后按 Enter。这将打开命令提示符窗口。
步骤 2: 安装 Python(如果尚未安装)
在安装 Django 之前,你需要确保 Python 已经安装在你的计算机上,因为 Django 是一个 Python 框架。
- 检查 Python 是否已安装:
- 在命令提示符窗口中输入以下命令并按 Enter:
python --version
-
- 如果系统显示 Python 的版本号,那么 Python 已安装。如果显示错误消息(比如 'python' 不是内部或外部命令,也不是可运行的程序或批处理文件),则需要安装 Python。
- 安装 Python:
- 访问 Python 官网 下载适用于 Windows 的 Python 安装程序。
- 下载后,双击安装文件并按提示进行安装。确保在安装过程中勾选“Add Python to PATH”选项,这将帮助你在命令提示符中直接使用 Python。
步骤 3: 安装 Django
- 安装 Django:
- 在命令提示符中,输入以下命令来安装 Django:
pip install django
-
- 按 Enter 执行命令。pip 是 Python 的包管理工具,用于安装和管理 Python 包。这条命令会从 Python 包索引下载并安装 Django。
- 确认 Django 安装成功:
- 安装完成后,你可以通过输入以下命令来检查 Django 是否成功安装:
django-admin --version
-
- 如果命令提示符显示 Django 的版本号,这表示 Django 已成功安装。
如果显示:'django-admin' 不是内部或外部命令,也不是可运行的程序 或批处理文件。
步骤 1: 确定 Python 脚本目录
- 找到 Python 的安装目录
- 找到 Scripts 目录
步骤 2: 将 Python 脚本目录添加到 PATH
- 打开环境变量编辑界面:
- 按 Win 键,输入“环境变量”并选择“编辑系统环境变量”(或在控制面板中找到系统属性 -> 高级 -> 环境变量)。
- 编辑 PATH 环境变量:
- 在“系统变量”区域找到 Path 变量,选择它然后点击“编辑”。
- 点击“新建”,在新的一行中粘贴 c:\users\administrator\appdata\roaming\python\python312\Scripts。
- 点击“确定”保存更改。
步骤 3: 重新打开命令提示符
- 关闭当前的命令提示符窗口。
- 再次按 Win+R,输入 cmd 打开新的命令提示符窗口。
步骤 4: 验证 django-admin 命令
- 在命令提示符中输入:
django-admin --version
- 如果一切设置正确,它应该显示 Django 的版本号。
步骤 4: 验证安装
- 验证:
- 在命令提示符窗口中,你可以通过执行 Django 提供的命令来测试 Django 是否能正确工作。例如,创建一个测试项目:
django-admin startproject testproject
-
- 这将在当前目录下创建一个名为 testproject 的新目录,里面包含了初始化的 Django 项目文件。
二、创建项目
既然 Django 已经成功安装,接下来我们可以创建一个 Django 项目,然后在项目中创建一个 app,并最后运行这个项目。以下是详细的步骤:
步骤 1: 创建一个新的 Django 项目
- 打开命令提示符:
- 按 Win+R,输入 cmd,然后按 Enter 打开命令提示符。
- 选择一个合适的目录来创建你的项目:
- 例如,如果你想在你的文档目录中创建项目,可以使用以下命令来切换到该目录:
cd %USERPROFILE%\Documents
-
- 或者,你可以创建一个新的目录:
mkdir MyDjangoProjects
cd MyDjangoProjects
- 创建项目:
- 使用 django-admin startproject 命令来创建一个新的 Django 项目。假设你想命名你的项目为 myproject:
django-admin startproject myproject
-
- 这个命令会在当前目录下创建一个名为 myproject 的新文件夹,里面包含了项目的基础结构。
步骤 2: 创建一个新的 Django app
- 切换到项目目录:
- 使用命令行切换到你的项目目录:
cd myproject
- 创建一个 app:
- 假设你想创建一个名为 myapp 的 app,可以使用 startapp 命令:
python manage.py startapp myapp
-
- 这将在项目目录下创建一个名为 myapp 的文件夹,包含了 app 的基础结构。
步骤 3: 注册你的 app
- 编辑 settings.py:
- 在项目文件夹中找到 settings.py 文件,通常路径是 myproject/myproject/settings.py。
- 在 INSTALLED_APPS 的列表中添加一行。
写上你的 app 名称(在此例中是 'myapp'),确保你的 app 名称是一个字符串,且放在引号内。添加的行应该如下所示:'myapp', # 添加你的 app
INSTALLED_APPS =
[
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'myapp', # 添加你的 app
]
步骤 4: 运行开发服务器
- 启动服务器:
在 Windows 上:按 Win+R,输入 cmd,然后按 Enter 打开命令提示符。
使用cd (change directory)命令切换到包含 manage.py 文件的目录。例如,如果你的Django项目位于:\Users\YourName\Documents\MyDjangoProjects\myproject,你应输入:
cd C:\Users\Administrator\Documents\myproject
-
- 确保你仍在项目的根目录下(即包含 manage.py 的目录)。运行以下命令启动 Django 开发服务器:
python manage.py runserver
-
- 这会启动一个本地 web 服务器,默认地址是 http://127.0.0.1:8000/。这将启动 Django 开发服务器,默认在端口 8000 上运行
- 验证项目运行:
- 打开你的网页浏览器,访问http://127.0.0.1:8000/ 或 http://localhost:8000/ 并按 Enter。你应该能看到 Django 的默认欢迎页面,这表示你的项目已经成功运行。
- 修改默认端口:
- 如果端口 8000 已被其他应用占用,或者你想使用不同的端口,可以通过添加端口号来启动服务器,例如使用端口 8080:
python manage.py runserver 8080
- 停止服务器:要停止服务器,只需在命令行界面中按 Ctrl+C。
- 如果端口 8000 已被其他应用占用,或者你想使用不同的端口,可以通过添加端口号来启动服务器,例如使用端口 8080:
三、导入项目
很好!你已经成功创建了 Django 项目并运行了开发服务器。现在,如果你想导入自己的代码并运行自己的程序,你可以按照以下步骤进行:
步骤 1: 编写你的 Django 应用代码
- 添加视图:
- 打开包含 manage.py 的目录(如果你不确定这个目录在哪里,你可以在命令行中使用 dir(Windows)或 ls(macOS/Linux)命令来查找包含 manage.py 的目录。),在项目根目录中,你会看到一个名为 myapp 的文件夹,你的 app 目录下有一个 views.py 文件,打开它。
- 这里,我们假设你的 app 名称为 myapp。在 C:\Users\Administrator\Documents\myproject\myapp\views.py 中编写一个简单的视图函数。例如,创建一个返回 "Hello, World!" 的视图:
from django.http import HttpResponse
def hello_world(request):
return HttpResponse("Hello, World!")
-
- 按 Ctrl+S 来保存你的更改。
- 配置 URL:
- 在你的 app 目录(C:\Users\Administrator\Documents\myproject\myapp)中创建一个新的 Python 文件,名为 urls.py。这个文件将用来定义该 app 的 URL 模式。
- 在 urls.py 文件中,你需要导入 path 以及你刚才在 views.py 中定义的视图函数,即添加以下代码:
from django.urls import path
from .views import hello_world
urlpatterns = [
path('', hello_world, name='hello_world'),
]
-
- 这段代码创建了一个 URL 模式,当访问你的站点根 URL 时,它会调用 hello_world 视图函数并显示其返回的内容。注意保存并关闭
- 链接项目的 URL 到你的 app:
- 打开项目级的 urls.py(跟刚刚不是一个,不需要新建,可以直接打开),通常位于 C:\Users\Administrator\Documents\myproject\myproject\urls.py。
- 确保文件顶部有以下导入语句(如果没有,请添加):
from django.contrib import admin
from django.urls import path, include # 引入 include 函数
-
- 引入 include 函数,并将你的 app 的 urls.py 包含到项目的 URL 配置中:
from django.contrib import admin
from django.urls import path, include # 引入 include 函数
urlpatterns = [
path('admin/', admin.site.urls),
path('', include('myapp.urls')), # 将 myapp 的 urls 包含进来
]
步骤 2: 运行你的 Django 应用
- 确保所有文件都保存了更改。
- 返回命令行,按 Win+R,键入 cmd,然后按 Enter 打开命令提示符。确保你仍在项目的根目录下(即包含 manage.py 的目录)。
cd C:\Users\Administrator\Documents\myproject
- 重新启动开发服务器(如果之前没有停止的话,首先按 Ctrl+C 停止服务器,然后重新启动):
python manage.py runserver
- 打开浏览器,访问 http://127.0.0.1:8000/。你应该能看到显示 "Hello, World!" 的页面。
- 验证你的 Django 应用是否运行:打开任何 web 浏览器。在地址栏中输入 http://127.0.0.1:8000/ 并按 Enter。你应该能够看到由你的 myapp 应用处理的结果,例如之前创建的 “Hello, World!” 页面。
步骤 3: 导入自定义代码
- 如果你有现成的 Python 代码或模块想导入到你的视图或其他地方,确保代码文件位于你的项目或 app 目录中。
- 使用 Python 的 import 语句导入这些模块,然后在你的视图或其他 Django 组件中使用这些导入的模块。