django框架内注册一个app

一、安装准备

首先，在 Windows 系统中安装 Django，这个过程会涉及使用命令提示符（CMD），这是 Windows 系统中用于执行命令的一个程序。我们将从最基础的操作开始：

步骤 1: 打开命令提示符

1. 打开运行对话框:
   • 按 Win+R 打开运行对话框。这里，Win 是键盘上带有 Windows 徽标的键。
2. 启动命令提示符:
   • 在运行对话框中输入 cmd 然后按 Enter。这将打开命令提示符窗口。

步骤 2: 安装 Python（如果尚未安装）

在安装 Django 之前，你需要确保 Python 已经安装在你的计算机上，因为 Django 是一个 Python 框架。

1. 检查 Python 是否已安装:
   • 在命令提示符窗口中输入以下命令并按 Enter：

python --version

1. • 如果系统显示 Python 的版本号，那么 Python 已安装。如果显示错误消息（比如 'python' 不是内部或外部命令，也不是可运行的程序或批处理文件），则需要安装 Python。
2. 安装 Python:
   • 访问 Python 官网 下载适用于 Windows 的 Python 安装程序。
   • 下载后，双击安装文件并按提示进行安装。确保在安装过程中勾选“Add Python to PATH”选项，这将帮助你在命令提示符中直接使用 Python。

步骤 3: 安装 Django

1. 安装 Django:
   • 在命令提示符中，输入以下命令来安装 Django：

pip install django

1. • 按 Enter 执行命令。pip 是 Python 的包管理工具，用于安装和管理 Python 包。这条命令会从 Python 包索引下载并安装 Django。
2. 确认 Django 安装成功:
   • 安装完成后，你可以通过输入以下命令来检查 Django 是否成功安装：

django-admin --version

• • 如果命令提示符显示 Django 的版本号，这表示 Django 已成功安装。

如果显示：'django-admin' 不是内部或外部命令，也不是可运行的程序 或批处理文件。

步骤 1: 确定 Python 脚本目录

1. 找到 Python 的安装目录
2. 找到 Scripts 目录

步骤 2: 将 Python 脚本目录添加到 PATH

1. 打开环境变量编辑界面：
   • 按 Win 键，输入“环境变量”并选择“编辑系统环境变量”（或在控制面板中找到系统属性 -> 高级 -> 环境变量）。
2. 编辑 PATH 环境变量：
   • 在“系统变量”区域找到 Path 变量，选择它然后点击“编辑”。
   • 点击“新建”，在新的一行中粘贴 c:\users\administrator\appdata\roaming\python\python312\Scripts。
   • 点击“确定”保存更改。

步骤 3: 重新打开命令提示符

• 关闭当前的命令提示符窗口。
• 再次按 Win+R，输入 cmd 打开新的命令提示符窗口。

步骤 4: 验证 django-admin 命令

• 在命令提示符中输入：

django-admin --version

• 如果一切设置正确，它应该显示 Django 的版本号。

步骤 4: 验证安装

1. 验证:
   • 在命令提示符窗口中，你可以通过执行 Django 提供的命令来测试 Django 是否能正确工作。例如，创建一个测试项目：

django-admin startproject testproject

• • 这将在当前目录下创建一个名为 testproject 的新目录，里面包含了初始化的 Django 项目文件。

二、创建项目

既然 Django 已经成功安装，接下来我们可以创建一个 Django 项目，然后在项目中创建一个 app，并最后运行这个项目。以下是详细的步骤：

步骤 1: 创建一个新的 Django 项目

1. 打开命令提示符：
   • 按 Win+R，输入 cmd，然后按 Enter 打开命令提示符。
2. 选择一个合适的目录来创建你的项目：
   • 例如，如果你想在你的文档目录中创建项目，可以使用以下命令来切换到该目录：

cd %USERPROFILE%\Documents

• • 或者，你可以创建一个新的目录：

mkdir MyDjangoProjects

cd MyDjangoProjects

1. 创建项目：
   • 使用 django-admin startproject 命令来创建一个新的 Django 项目。假设你想命名你的项目为 myproject：

django-admin startproject myproject

• • 这个命令会在当前目录下创建一个名为 myproject 的新文件夹，里面包含了项目的基础结构。

步骤 2: 创建一个新的 Django app

1. 切换到项目目录：
   • 使用命令行切换到你的项目目录：

cd myproject

1. 创建一个 app：
   • 假设你想创建一个名为 myapp 的 app，可以使用 startapp 命令：

python manage.py startapp myapp

• • 这将在项目目录下创建一个名为 myapp 的文件夹，包含了 app 的基础结构。

步骤 3: 注册你的 app

1. 编辑 settings.py：
   • 在项目文件夹中找到 settings.py 文件，通常路径是 myproject/myproject/settings.py。
   • 在 INSTALLED_APPS 的列表中添加一行。

     'myapp',  # 添加你的 app

     写上你的 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: 运行开发服务器

1. 启动服务器：

在 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

1. • 这会启动一个本地 web 服务器，默认地址是 http://127.0.0.1:8000/。这将启动 Django 开发服务器，默认在端口 8000 上运行
2. 验证项目运行：
   • 打开你的网页浏览器，访问http://127.0.0.1:8000/ 或 http://localhost:8000/ 并按 Enter。你应该能看到 Django 的默认欢迎页面，这表示你的项目已经成功运行。
3. 修改默认端口：
   • 如果端口 8000 已被其他应用占用，或者你想使用不同的端口，可以通过添加端口号来启动服务器，例如使用端口 8080：

     python manage.py runserver 8080

   • 停止服务器：要停止服务器，只需在命令行界面中按 Ctrl+C。

三、导入项目

很好！你已经成功创建了 Django 项目并运行了开发服务器。现在，如果你想导入自己的代码并运行自己的程序，你可以按照以下步骤进行：

步骤 1: 编写你的 Django 应用代码

1. 添加视图:
   • 打开包含 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 来保存你的更改。

1. 配置 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'),
]

1. • 这段代码创建了一个 URL 模式，当访问你的站点根 URL 时，它会调用 hello_world 视图函数并显示其返回的内容。注意保存并关闭
2. 链接项目的 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 应用

1. 确保所有文件都保存了更改。
2. 返回命令行，按 Win+R，键入 cmd，然后按 Enter 打开命令提示符。确保你仍在项目的根目录下（即包含 manage.py 的目录）。

cd C:\Users\Administrator\Documents\myproject

1. 重新启动开发服务器（如果之前没有停止的话，首先按 Ctrl+C 停止服务器，然后重新启动）：

python manage.py runserver

1. 打开浏览器，访问 http://127.0.0.1:8000/。你应该能看到显示 "Hello, World!" 的页面。
2. 验证你的 Django 应用是否运行：打开任何 web 浏览器。在地址栏中输入 http://127.0.0.1:8000/ 并按 Enter。你应该能够看到由你的 myapp 应用处理的结果，例如之前创建的 “Hello, World!” 页面。

步骤 3: 导入自定义代码

• 如果你有现成的 Python 代码或模块想导入到你的视图或其他地方，确保代码文件位于你的项目或 app 目录中。
• 使用 Python 的 import 语句导入这些模块，然后在你的视图或其他 Django 组件中使用这些导入的模块。